{"id":13588833,"url":"https://github.com/fabiospampinato/cliflix","last_synced_at":"2025-09-28T23:32:27.299Z","repository":{"id":49575179,"uuid":"102234516","full_name":"fabiospampinato/cliflix","owner":"fabiospampinato","description":"Watch anything instantaneously, just write its name.","archived":true,"fork":false,"pushed_at":"2021-06-14T00:46:49.000Z","size":7148,"stargazers_count":1492,"open_issues_count":11,"forks_count":64,"subscribers_count":25,"default_branch":"master","last_synced_at":"2025-01-15T15:56:22.076Z","etag":null,"topics":["cli","cliflix","stream","torrent","watch"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fabiospampinato.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-03T01:51:51.000Z","updated_at":"2024-12-29T19:09:24.000Z","dependencies_parsed_at":"2022-08-28T07:22:07.841Z","dependency_job_id":null,"html_url":"https://github.com/fabiospampinato/cliflix","commit_stats":null,"previous_names":["fabiospampinato/watch"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabiospampinato%2Fcliflix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabiospampinato%2Fcliflix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabiospampinato%2Fcliflix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabiospampinato%2Fcliflix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fabiospampinato","download_url":"https://codeload.github.com/fabiospampinato/cliflix/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234575214,"owners_count":18854924,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","cliflix","stream","torrent","watch"],"created_at":"2024-08-01T15:06:58.107Z","updated_at":"2025-09-28T23:32:26.058Z","avatar_url":"https://github.com/fabiospampinato.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","cli"],"sub_categories":[],"readme":"# CLIFlix\n\nWatch anything instantaneously, just write its name.\n\nIt searches a torrent for you and streams it using [WebTorrent](https://github.com/fabiospampinato/webtorrent-cli/tree/iina-pip) to your favorite app. It supports subtitles too.\n\n\u003e **Warning**: If you don't know what a torrent is, or are unsure about the legality of the torrents you're downloading you shouldn't use `cliflix`.\n\n## Install\n\n```shell\n$ npm install -g cliflix\n```\n\n## Usage\n\n#### Wizard\n\nExecute `cliflix` to run a wizard, it'll ask you everything it needs: a search query, which torrent to stream, and which app to use. If you want it may also search for subtitles for you.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/wizard.gif\" width=\"631\" alt=\"Wizard\"\u003e\n\u003c/p\u003e\n\n#### I'm Feeling Lucky\n\nIf you're feeling lucky, just run something like this to automatically pick the first result:\n\n```shell\ncliflix Sintel\n```\n\n#### Manual\n\nYou can also directly pass any of the valid torrent identifiers supported by [parse-torrent](https://github.com/webtorrent/parse-torrent) to stream it:\n\n```shell\ncliflix \"magnet:?xt=urn:btih:08ada5a7a6183aae1e09d831df6748d566095a10\u0026dn=Sintel\u0026tr=udp%3A%2F%2Fexplodie.org%3A6969\u0026tr=udp%3A%2F%2Ftracker.coppersurfer.tk%3A6969\u0026tr=udp%3A%2F%2Ftracker.empire-js.us%3A1337\u0026tr=udp%3A%2F%2Ftracker.leechers-paradise.org%3A6969\u0026tr=udp%3A%2F%2Ftracker.opentrackr.org%3A1337\u0026tr=wss%3A%2F%2Ftracker.btorrent.xyz\u0026tr=wss%3A%2F%2Ftracker.fastcast.nz\u0026tr=wss%3A%2F%2Ftracker.openwebtorrent.com\u0026ws=https%3A%2F%2Fwebtorrent.io%2Ftorrents%2F\u0026xs=https%3A%2F%2Fwebtorrent.io%2Ftorrents%2Fsintel.torrent\"\n```\n\n#### WebTorrent Options\n\nYou can pass arbitrary options to [WebTorrent](https://github.com/fabiospampinato/webtorrent-cli/tree/iina-pip), read more about them [here](https://github.com/fabiospampinato/webtorrent-cli/tree/iina-pip). Just write them after the special `--` argument:\n\n```shell\ncliflix -- --iina --pip\ncliflix -- --vlc --port 1234\ncliflix Sintel -- --vlc --port 1234\n```\n\n## Configuration\n\nYou can customize `cliflix` to your likings via a `~/.cliflix.json` file.\n\nThese are the settings available:\n\n```js\n{\n  \"downloads\": { // Downloads-related settings\n    \"path\": \"~/Downloads\", // If saving them, put them here\n    \"save\": true // Save the downloaded torrents or delete them upon exit\n  },\n  \"outputs\": { // Apps-related settings\n    \"available\": [\"Airplay\", \"Chromecast\", \"DLNA\", \"MPlayer\", \"mpv\", \"VLC\", \"IINA\", \"XBMC\"], // Apps to list when asking for the app\n    \"favorites\": [\"VLC\"] // Favorite apps, they will be listed before the others\n  },\n  \"torrents\": { // Torrents-related settings\n    \"limit\": 30, // Number of torrents to show\n    \"details\": { // Extra columns to show\n      \"seeders\": true,\n      \"leechers\": true,\n      \"size\": true,\n      \"time\": false\n    },\n    \"providers\": { // Torrents providers-related settings\n      \"available\": [\"1337x\", \"ThePirateBay\", \"ExtraTorrent\", \"Rarbg\", \"Torrent9\", \"KickassTorrents\", \"TorrentProject\", \"Torrentz2\"], // Providers to list if none is active\n      \"active\": \"1337x\" // Active provider\n    }\n  },\n  \"subtitles\": { // Subtitles-related settings\n    \"limit\": 30, // Number of subtitles to show\n    \"details\": { // Extra columns to show\n      \"downloads\": true\n    },\n    \"languages\": { // Languages-related settings\n      \"available\": [\"Afrikaans\", \"...\"], // Languages to list when asking for the subtitles' language\n      \"favorites\": [\"English\", \"...\"] // Favorite languages, they will be listed before the others\n    },\n    \"opensubtitles\": { // OpenSubtitles-related settings\n      \"username\": null, // Your OpenSubtitles username, required for increasing your IP quota\n      \"password\": null, // Your OpenSubtitles password, required for increasing your IP quota\n      \"ssl\": true\n    }\n  },\n  \"webtorrent\": { // WebTorrent-related options\n    \"options\": [ // Custom options to always pass to WebTorrent\n      '--keep-seeding'\n    ]\n  }\n}\n```\n\n## License\n\nMIT © Fabio Spampinato\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabiospampinato%2Fcliflix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabiospampinato%2Fcliflix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabiospampinato%2Fcliflix/lists"}