{"id":13826033,"url":"https://github.com/lkabuci/Botflix","last_synced_at":"2025-07-08T23:30:41.244Z","repository":{"id":36995175,"uuid":"442921769","full_name":"lkabuci/Botflix","owner":"lkabuci","description":"🎥 Stream your favorite movie from the terminal!","archived":true,"fork":false,"pushed_at":"2024-09-11T10:34:44.000Z","size":1133,"stargazers_count":423,"open_issues_count":4,"forks_count":26,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-10-01T02:04:21.888Z","etag":null,"topics":["cli","movie","movies","mpv","nodejs","stream","streaming","streams","terminal","torrents","vlc","webtorrent"],"latest_commit_sha":null,"homepage":"","language":"Python","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/lkabuci.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-12-30T00:11:36.000Z","updated_at":"2024-09-19T00:54:51.000Z","dependencies_parsed_at":"2023-01-17T12:47:54.318Z","dependency_job_id":"7a1e14af-be81-4dc3-84fb-df53fa4b7b69","html_url":"https://github.com/lkabuci/Botflix","commit_stats":null,"previous_names":["lkabuci/botflix"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lkabuci%2FBotflix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lkabuci%2FBotflix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lkabuci%2FBotflix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lkabuci%2FBotflix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lkabuci","download_url":"https://codeload.github.com/lkabuci/Botflix/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225470631,"owners_count":17479366,"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","movie","movies","mpv","nodejs","stream","streaming","streams","terminal","torrents","vlc","webtorrent"],"created_at":"2024-08-04T09:01:31.047Z","updated_at":"2024-11-20T04:31:13.415Z","avatar_url":"https://github.com/lkabuci.png","language":"Python","readme":"\u003cdiv align=\"center\" style=\"background-color: #ffcccc; border: 2px solid #ff0000; padding: 15px; margin: 20px 0; border-radius: 5px;\"\u003e\n  \u003ch2 style=\"color: #ff0000; text-align: center; margin-top: 0;\"\u003e⚠️ REPOSITORY ARCHIVED ⚠️\u003c/h2\u003e\n  \u003cp style=\"font-size: 16px; text-align: center;\"\u003e\n    This repository is no longer actively maintained.\u003cbr\u003e\n    It has been archived for historical reference.\u003cbr\u003e\n    Thank you to all contributors and users of this project.\u003cbr\u003e\n    Last updated: Oct 21, 2023\n  \u003c/p\u003e\n  \u003chr style=\"border-top: 1px solid #ff0000; margin: 15px 0;\"\u003e\n  \u003cp\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\n\u003cp align=\"center\"\u003e\n\n  \u003cimg src=\"https://github.com/kaboussi/Botflix/assets/65725801/a0f2db38-fe3c-48af-b63c-30b6aabcd288\" /\u003e\n\u003c/p\u003e\n\n\u003ch2 align='center'\u003e Botflix \u003c/h2\u003e\n\n\u003cdiv align='center'\u003e\n\u003ca href=\"https://aur.archlinux.org/packages/botflix-git\"\u003e\n\t\n![AUR version](https://img.shields.io/aur/version/botflix-git)\n\n\u003c/a\u003e\n\u003c/div\u003e\n\nBotflix is a Python scrapping CLI that combines [scrapy](https://scrapy.org) and [webtorrent](https://github.com/webtorrent/webtorrent-cli) in one command for streaming movies from your terminal.\n\n## Installation:\n#### For ArchLinux or Arch-based distro:\nYou can install it manually from [AUR repository](https://aur.archlinux.org/packages/botflix-git) or use a aur helper like `yay` or `paru`.\n```bash\nyay -Syu botflix-git\n```\nTo run\n```bash\nbotflix\n```\n`botflix` is the replacement for the command prefix `python3 main.py` in this readme. for example `python3 main.py config \"vlc\"` will be `botflix config \"vlc\"`, the final step after installation.\n#### For others\n\u003e Botflix is written in Python, and it depends on [webtorrent](https://github.com/webtorrent/webtorrent-cli), [NodeJS](https://nodejs.org) and [npm](https://www.npmjs.com)\n\n1. install NodeJS on your machine ([read mode](https://nodejs.org/en/download/)).\n```bash\nnode --version\nv17.9.0 #or higher\n```\n2. make sure that you have npm already installed ([read more](https://docs.npmjs.com/cli/v7/configuring-npm/install)).\n```bash\nnpm --version\n8.8.0 # or higher\n```\n3. now let's install webtorrent ([read more](https://github.com/webtorrent/webtorrent-cli)).\n```bash\nnpm install webtorrent-cli -g\nwebtorrent --version # 4.0.4 (1.8.16)\n```\n_Note: if not installed try with sudo privileges._\n\n4. clone the repo in your local machine.\n```bash\n    git clone https://github.com/kaboussi/Botflix \u0026\u0026 cd Botflix\n```\n![clone results](.github/clone.png)\n\n5. create a virtual environment.\n* Beginner Windows users who couldn't set up the [virtualenv] check this doc.\n* Unix Users\n```bash\npython3 -m venv venv \u0026\u0026 source venv/bin/activate\n```\n![creating virtualenv](.github/virtualenv.png)  \n**Note**: on Debian/Ubuntu systems you will first need to install venv using \n```bash\nsudo apt install python3-venv\n```\n\n6. Install necessary packages.\n```bash\npip install -r requirements.txt\n```\n![install packages](.github/pipintsall.png)\n\n## Usage:\n* First you need to set up a default player.\n\u003e Note that only [vlc](https://www.videolan.org/vlc/) and [mpv](https://mpv.io/) are supported. \u003cbr\u003e\n\u003e If you are a Windows user, make sure you add your player to the PATH. [read more](https://www.vlchelp.com/add-vlc-command-prompt-windows/)\n```bash\npython3 main.py config \"vlc\"\n```\n![config](.github/config.png)\n* If you want to get top movies:\n```bash\npython3 main.py top\n```\n* If you want to watch a TV Series:\n```bash\npython3 main.py serie\n```\n* If you want to search for a specific movie (_\"[red notice](https://www.imdb.com/title/tt7991608/)\"_ for example):\n```bash\npython3 main.py search\nWhat movie are you looking for? red notice\n```\n![table of search](.github/table_of_movies.png \"table of search\")\n* To start watching you can just type the number of the movie in the table.\n\n## Contributing:\nContributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\". Don't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch `git checkout -b feature/AmazingFeature`\n3. Commit your Changes `git commit -m 'Add some AmazingFeature`\n4. Push to the Branch `git push origin feature/AmazingFeature`\nOpen a Pull Request.\n\n## Contributors❤:\n\u003cdiv align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/kaboussi/Botflix/graphs/contributors\"\u003e\n  \t\u003cimg src=\"https://contrib.rocks/image?repo=kaboussi/Botflix\" /\u003e\n\t\u003c/a\u003e\n\u003c/div\u003e\n\n## License:\n[MIT](https://mit-license.org/)\u003cbr\u003e\n[DISCLAIMER](https://www.disclaimertemplate.net/live.php?token=xyytrgo4QtkLMNCB6LEIO6Q39YDFyhu2)\n\n\n\n\u003c!-- Links --\u003e\n[virtualenv]: https://github.com/kaboussi/Botflix/blob/main/docs/windowsVenv.md\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flkabuci%2FBotflix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flkabuci%2FBotflix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flkabuci%2FBotflix/lists"}