{"id":19529771,"url":"https://github.com/wraient/octopus","last_synced_at":"2025-10-30T07:21:01.823Z","repository":{"id":260152145,"uuid":"880468724","full_name":"Wraient/octopus","owner":"Wraient","description":"Watch TV Show / Movies with cli","archived":false,"fork":false,"pushed_at":"2024-11-01T05:03:49.000Z","size":60,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-01T05:25:45.106Z","etag":null,"topics":["cli","movies","shows","stream","streaming","tv"],"latest_commit_sha":null,"homepage":"","language":"Go","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/Wraient.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,"publiccode":null,"codemeta":null}},"created_at":"2024-10-29T19:27:36.000Z","updated_at":"2024-11-01T05:03:52.000Z","dependencies_parsed_at":"2024-11-01T05:25:50.977Z","dependency_job_id":"b3a9d581-b625-42da-a867-ad80f37ce8e9","html_url":"https://github.com/Wraient/octopus","commit_stats":null,"previous_names":["wraient/flick","wraient/octopus"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wraient%2Foctopus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wraient%2Foctopus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wraient%2Foctopus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wraient%2Foctopus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wraient","download_url":"https://codeload.github.com/Wraient/octopus/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224034498,"owners_count":17244798,"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","movies","shows","stream","streaming","tv"],"created_at":"2024-11-11T01:27:34.433Z","updated_at":"2025-10-30T07:21:01.737Z","avatar_url":"https://github.com/Wraient.png","language":"Go","readme":"# Octopus\n\nOctopus is a CLI tool for managing and watching TV shows and movies directly from the terminal or using Rofi for a GUI selection. Designed for simplicity and control, Octopus allows seamless playback and tracking of episodes with customizable options.\n\n## **Important** \n`Octopus` uses [vadapav.mov](https://vadapav.mov) API and It also hosts the content. Please consider donating to [vadapav.mov](https://vadapav.mov)\n\nBitcoin \n```\nbc1q8yxttnkuf3fygzxffj5wd85fgya0w39nr5tkau\n```\n\nMonero\n```\n42UXZfPr4SyZ4StxqNtA9HdvNr8ieSuMYdPxs3zL7qrKUnrWCMMUAuH9ARC342732VPS3KU6R8JbN15HWEdR234aPWF5ned\n```\n## Demo\n\nCLI mode:\n\nhttps://github.com/user-attachments/assets/c0578473-d463-41b9-aef5-346ecc1b05ce\n\nRofi mode:\n\nhttps://github.com/user-attachments/assets/c751fdea-472d-4748-ba9e-b8d2a4885d07\n\n\n## Features\n\n- **Watch shows/movies**: Stream media directly in the CLI or through Rofi.\n- **Playback management**: Continue, pause, and resume playback using MPV.\n- **Progress tracking**: Automatically marks episodes as watched based on custom percentage.\n- **Configurable storage and playback**: Set custom storage paths and MPV playback settings.\n- **Customizable through CLI options**: Toggle between CLI and Rofi interface, configure playback speed, and more.\n\n## Installing and Setup\n\u003e **Note**: `Octopus` requires `mpv`, `rofi` for Video playback and Rofi support. These are included in the installation instructions below for each distribution.\n\n### Linux\n\u003cdetails\u003e\n\u003csummary\u003eArch Linux / Manjaro (AUR-based systems)\u003c/summary\u003e\n\nUsing Yay\n\n```\nyay -Sy octopus-player\n```\n\nor using Paru:\n\n```\nparu -Sy octopus-player\n```\n\nOr, to manually clone and install:\n\n```bash\ngit clone https://aur.archlinux.org/octopus.git\ncd octopus\nmakepkg -si\nsudo pacman -S rofi \n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e Debian / Ubuntu (and derivatives) \u003c/summary\u003e\n\n```bash\nsudo apt update\nsudo apt install mpv curl rofi\ncurl -Lo octopus https://github.com/Wraient/octopus/releases/latest/download/octopus\nchmod +x octopus\nsudo mv octopus /usr/local/bin/\noctopus\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eFedora Installation\u003c/summary\u003e\n\n```bash\nsudo dnf update\nsudo dnf install mpv curl rofi\ncurl -Lo octopus https://github.com/Wraient/octopus/releases/latest/download/octopus\nchmod +x octopus\nsudo mv octopus /usr/local/bin/\noctopus\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eopenSUSE Installation\u003c/summary\u003e\n\n```bash\nsudo zypper refresh\nsudo zypper install mpv curl rofi\ncurl -Lo octopus https://github.com/Wraient/octopus/releases/latest/download/octopus\nchmod +x octopus\nsudo mv octopus /usr/local/bin/\noctopus\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eGeneric Installation\u003c/summary\u003e\n\n```bash\n# Install mpv, curl, rofi\ncurl -Lo octopus https://github.com/Wraient/octopus/releases/latest/download/octopus\nchmod +x octopus\nsudo mv octopus /usr/local/bin/\noctopus\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eUninstallation\u003c/summary\u003e\n\n```bash\nsudo rm /usr/local/bin/octopus\n```\n\nFor AUR-based distributions:\n\n```bash\nyay -R octopus\n```\n\u003c/details\u003e\n\n### [Windows Installer](https://github.com/Wraient/octopus/releases/latest/download/OctopusInstaller.exe)\n\n\n## Usage\n\nRun `octopus -h` to see available commands and options:\n\nHere's a table version for the command options:\n\n| Option                          | Description                                                                          | Default                     |\n|---------------------------------|--------------------------------------------------------------------------------------|-----------------------------|\n| `-e`                            | Edit the Octopus configuration file                                                    | N/A                         |\n| `-next-episode-prompt`          | Prompt for the next episode playback (accepts true/false)                            | N/A                         |\n| `-no-rofi`                      | Disable the Rofi interface; run in CLI mode                                          | N/A                         |\n| `-percentage-to-mark-complete`  | Set the percentage of an episode to mark as complete                                 | `92`                        |\n| `-player`                       | Set player for playback (only MPV supported)                                         | `\"mpv\"`                     |\n| `-rofi`                         | Enable Rofi interface for selection                                                  | N/A                         |\n| `-save-mpv-speed`               | Save MPV speed setting (accepts true/false)                                          | `true`                      |\n| `-storage-path`                 | Define custom path for storage directory                                             | `$HOME/.local/share/octopus`  |\n| `-update`                       | Update the Octopus script                                                              | N/A                         |\n\nThis makes it easy to scan and find each option’s purpose and default values!\n\n### Examples\n\n- **Watch with Rofi interface**:\n  ```\n  octopus -rofi\n  ```\n- **Play next episode in CLI**:\n  ```\n  octopus -next-episode-prompt\n  ```\n- **Change storage path**:\n  ```\n  octopus -storage-path=\"/custom/path\"\n  ```\n\n## Configuration\n\nEdit the Octopus configuration file to customize settings:\n```\noctopus -e\n```\n\n## Dependencies\n- mpv - Video player (vlc support might be added later)\n- rofi - Selection menu\n\n# API Used\n- [vadapav.mov](https://vadapav.mov)\n\n## License\n\nOctopus is open-source software licensed under the [MIT License](LICENSE).\n\n# Credits\n- [Lobster](https://github.com/justchokingaround/lobster) - For the motivation\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwraient%2Foctopus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwraient%2Foctopus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwraient%2Foctopus/lists"}