sumonst21/FreeTubeCordova

An open source YouTube player built with privacy in mind.

Screenshots • How does it work? • Features • Building and testing • Contributing • Localization • Contact • Donate • License

Website • Blog • Documentation • FAQ • Discussions

FreeTube Cordova is an open source YouTube player built with privacy in mind. Use YouTube without advertisements and prevent Google from tracking you with their cookies and JavaScript. Available for Android and as a PWA. FreeTube Cordova is a fork of FreeTube. FreeTube Cordova is currently in Beta. While it should work well for most users, there are still bugs and missing features that need to be addressed.

Download FreeTubeCordova

How does it work?

FreeTube Cordova uses the Invidious API to serve data and videos. No official YouTube APIs are used to obtain data. Your subscriptions and history are stored locally on your device and are never sent out.

Features

Watch videos without ads
Use YouTube without Google tracking you using cookies and JavaScript
Subscribe to channels without an account
Connect to an externally setup proxy such as Tor
View and search your local subscriptions, history, and saved videos
Organize your subscriptions into "Profiles" to create a more focused feed
Export & import subscriptions
Youtube Trending
Youtube Chapters
Most popular videos page based on the set Invidious instance
SponsorBlock
Full Theme support
Multiple windows
Mini Player (Picture-in-Picture)
Keyboard shortcuts
Option to show only family friendly content
Show/hide functionality or elements within the app using the distraction free settings

Go to FreeTube's Documentation if you'd like to know more about how to operate FreeTube and its features.

Screenshots

How to install

There is a deployed PWA (progressive web app) available here:

https://marmadilemanteater.github.io/freetube/#/

There is an APK which can be downloaded here:

https://github.com/MarmadileManteater/FreeTubeCordova/releases

Automated Builds (Nightly / Weekly)

Builds are automatically created from changes to our development branch via GitHub Actions.

The first build with a green check mark is the latest build. You will need to have a GitHub account to download these builds.

How to build and test

Commands for the Android APK

# 📦 Packs the project using `webpack.cordova.config.js`
yarn pack:cordova
# 🏗 Builds the debug APK and launches it on a connected device
yarn run:cordova
# 🚧 Builds the development APK
yarn build:cordova
# 🏦 Builds the release APK
yarn build:cordova --release

Commands for the PWA (progressive web app)

# 🐛 Debugs the project using `webpack.web.config.js`
yarn dev:web
# 📦 Packs the project using `webpack.web.config.js` 
yarn pack:web

Commands for the PWA Docker Image

# 💨 Creates and runs the image locally. Add `--platform=linux/arm64` to docker build for ARM64 devices including Apple Silicon
docker build -t freetubecordova . # Warning, might take a while on Apple Silicon
docker run --name ftcordova -d -p 8080:80 freetubecordova

# ⬇ Pulls the latest from the Github Container Registry (ghcr.io)
docker pull ghcr.io/marmadilemanteater/freetubecordova:latest
# 👟 Runs the image from ghcr.io
docker run --name ftcordova -d -p 8080:80 ghcr.io/marmadilemanteater/freetubecordova:latest

# 🏃 Runs the image from Docker Hub.
docker run --name ftcordova -d -p 8080:80 owentruong/freetubecordova:latest

# 🏃‍♂️ Runs the image from Docker Hub (ARM64)
docker run --platform=linux/arm64 --name ftcordova -d -p 8080:80 owentruong/freetubecordova:latest-arm64

Contributing

NOTICE: MOST CHANGES SHOULD PROBABLY BE MADE TO UPSTREAM UNLESS DIRECTLY RELATED TO CORDOVA CODE OR WORKFLOWS.

If you like to get your hands dirty and want to contribute, we would love to have your help. Send a pull request and someone will review your code. Please follow the Contribution Guidelines before sending your pull request.

Localization

If you'd like to localize FreeTubeCordova, please send submissions to FreeTube's weblate.

Contact

If you ever have any questions, feel free to make an issue here on GitHub.

Upstream Donations

If you enjoy using FreeTubeCordova, you're welcome to leave a donation using the following methods to support upstream development and maintenance.

FreeTube on Liberapay
Bitcoin Address: 1Lih7Ho5gnxb1CwPD4o59ss78pwo2T91eS
Monero Address: 48WyAPdjwc6VokeXACxSZCFeKEXBiYPV6GjfvBsfg4CrUJ95LLCQSfpM9pvNKy5GE5H4hNaw99P8RZyzmaU9kb1pD7kzhCB

While your donations are much appreciated, only donate if you really want to. Donations are used for keeping the website up and running and eventual code signing costs.

License

FreeTube is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

sumonst21 / FreeTubeCordova