base on Invidious client for android # Clipious [](https://www.gnu.org/licenses/agpl-3.0.en.html) Android client application for [invidious](https://invidious.io), the privacy focused youtube front end [](https://drone.ftpix.com/lamarios/clipious) ## Community [Join the matrix channel](https://matrix.to/#/#clipious:matrix.org) ## License Copyright (C) 2023 Paul Fauchon This program is free software: you can redistribute it 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. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see <https://www.gnu.org/licenses/>. ## Features - Use own or public server - Subscription management - SponsorBlock + DeArrow (click bait removal) - Video view/progress tracking - Playlists - background playback - Live stream support - Android TV ui - Audio playback - Video / audio download - Video filtering - Return YouTube dislikes ## Installation The best way to install is to get it directly from the release page. Using [Obtainium](https://github.com/ImranR98/Obtainium) can help keeping the app up to date. It is also available on F-Droid, IzzyOnDroid, and Accrescent: [<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="80">](https://f-droid.org/packages/com.github.lamarios.clipious/) [<img src="https://accrescent.app/badges/get-it-on.png" alt='Get it on Accrescent' height="80">](https://accrescent.app/app/com.github.lamarios.clipious) Or download the latest APK from the [Releases Section](https://github.com/lamarios/clipious/releases/latest). ### TV For TV users it is recommended to use [Accrescent](https://accrescent.app) as it works well enough on TV and allows updates. ## Screenshots ### Phone [](./screenshots/mobile-home.png) [](./screenshots/mobile-video.png) [](./screenshots/mobile-channel_small.png) [](./screenshots/mobile-playlist_small.png) ### Tablet [](./screenshots/tablet-home.png) [](./screenshots/tablet-video.png) [](./screenshots/tablet-channel_small.png) [](./screenshots/tablet-playlist_small.png) ### TV [](./screenshots/tv-home.png) [](./screenshots/tv-home-2.png) [](./screenshots/tv-video.png) [](./screenshots/tv-video-2.png) [](./screenshots/tv-channel_small.png) [](./screenshots/tv-playlist_small.png) [](./screenshots/tv-playlist_small-2.png) ## Facing an issue ? - Check the [Common issue wiki page](https://github.com/lamarios/clipious/wiki/Common-Issues) - Open an issue ## Contribute ### Code To get started, you'll need to create a fork of the repo and might run: ``` git submodule init git submodule update #enable git pre commit hooks for auto formatting ./submodules/flutter/bin/dart run tools/setup_git_hooks.dart ``` or using nix that will handle all the above plus starting a working invidious instance with user test and password test. ``` nix-shell ``` Flutter itself is used as a submodule of this repo in order to pin the version I want to use to enable reproducible build on f-droid You'll need to also set up your android SDK and a device / emulator to run the app on. #### Tests The app has some tests and they expect to have a locally running invidious server, with a test user (password test). The easy way it to use [nix](https://nixos.org) and run ``` nix-shell ``` That will spin a postgres DB, an invidious server and the required user (this is how the tests are run in the ci/cd). Nothing keeps you to run your own user docker or other ways. Alternatively, you can directly run the tests with its environment: ``` nix-shell --run './submodules/flutter/bin/flutter test' ``` ### Translations  The translations are done via [weblate](https://hosted.weblate.org/projects/clipious/app-translation/). ## Liability We take no responsibility for the use of our tool, or external instances provided by third parties. We strongly recommend you abide by the valid official regulations in your country. Furthermore, we refuse liability for any inappropriate use of Invidious, such as illegal downloading. This tool is provided to you in the spirit of free, open software. You may view the LICENSE in which this software is provided to you [here](./LICENSE). > 16. Limitation of Liability. > > IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. > ", Assign "at most 3 tags" to the expected json: {"id":"9967","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"