{"id":19529780,"url":"https://github.com/wraient/buttercup","last_synced_at":"2025-07-12T08:08:27.568Z","repository":{"id":261798473,"uuid":"885360096","full_name":"Wraient/buttercup","owner":"Wraient","description":"Torrent and stream Shows / Movies with cli with playback tracking","archived":false,"fork":false,"pushed_at":"2024-11-15T13:14:18.000Z","size":76,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-07T16:50:11.751Z","etag":null,"topics":["cli","linux","movies","mpv","shows","stream","streaming","torrent","tv-shows","webtorrent"],"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,"zenodo":null}},"created_at":"2024-11-08T12:43:50.000Z","updated_at":"2025-04-17T08:22:19.000Z","dependencies_parsed_at":"2025-05-07T16:39:05.444Z","dependency_job_id":null,"html_url":"https://github.com/Wraient/buttercup","commit_stats":null,"previous_names":["wraient/buttercup"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Wraient/buttercup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wraient%2Fbuttercup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wraient%2Fbuttercup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wraient%2Fbuttercup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wraient%2Fbuttercup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wraient","download_url":"https://codeload.github.com/Wraient/buttercup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wraient%2Fbuttercup/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264958623,"owners_count":23689035,"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","linux","movies","mpv","shows","stream","streaming","torrent","tv-shows","webtorrent"],"created_at":"2024-11-11T01:27:39.599Z","updated_at":"2025-07-12T08:08:27.562Z","avatar_url":"https://github.com/Wraient.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# buttercup\n\nA cli application to stream torrents and track the playback using [jackett](https://github.com/Jackett/Jackett) and [webtorrent-cli](https://github.com/webtorrent/webtorrent-cli)\n\n## Join the discord server\n\nhttps://discord.gg/cNaNVEE3B6\n\n## Demo\n\nThe demo speed has been increased, real speed would be slower depending on number of seeders and leechers\n\nCli Mode:\n\nhttps://github.com/user-attachments/assets/59a17262-46b8-4cdd-bd79-3c362d72f2c6\n\nRofi Mode:\n\nhttps://github.com/user-attachments/assets/c2c18047-b76a-4c98-a00d-fdab9e8fde5c\n\n\n## Features\n- Search for torrents\n- Stream torrents\n- Track playback\n- Save MPV Speed\n- Download / Install Jackett\n- Config file\n- CLI Selection menu\n- Rofi Support\n\n## Installing and Setup\n\u003e **Note**: `buttercup` requires `mpv`, `rofi`, and `webtorrent-cli` for Rofi support and torrent streaming. 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```bash\nyay -Sy buttercup\n```\n\nor using Paru:\n\n```bash\nparu -Sy buttercup\n```\n\nOr, to manually clone and install:\n\n```bash\ngit clone https://aur.archlinux.org/buttercup.git\ncd buttercup\nmakepkg -si\nsudo pacman -S rofi npm\nnpm install -g webtorrent-cli\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eDebian / Ubuntu (and derivatives)\u003c/summary\u003e\n\n```bash\nsudo apt update\nsudo apt install -y mpv curl rofi npm\nsudo npm install -g webtorrent-cli\ncurl -Lo buttercup https://github.com/Wraient/buttercup/releases/latest/download/buttercup\nchmod +x buttercup\nsudo mv buttercup /usr/local/bin/\nbuttercup\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 -y mpv curl rofi npm\nsudo npm install -g webtorrent-cli\ncurl -Lo buttercup https://github.com/Wraient/buttercup/releases/latest/download/buttercup\nchmod +x buttercup\nsudo mv buttercup /usr/local/bin/\nbuttercup\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 -y mpv curl rofi npm\nsudo npm install -g webtorrent-cli\ncurl -Lo buttercup https://github.com/Wraient/buttercup/releases/latest/download/buttercup\nchmod +x buttercup\nsudo mv buttercup /usr/local/bin/\nbuttercup\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eGeneric Installation\u003c/summary\u003e\n\n```bash\n# Install mpv, curl, rofi, npm, and webtorrent-cli (required for torrent streaming)\n# Install npm for any additional packages\n\ncurl -Lo buttercup https://github.com/Wraient/buttercup/releases/latest/download/buttercup\nchmod +x buttercup\nsudo mv buttercup /usr/local/bin/\nbuttercup\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eUninstallation\u003c/summary\u003e\n\n```bash\nsudo rm /usr/local/bin/buttercup\n```\n\nFor AUR-based distributions:\n\n```bash\nyay -R buttercup\n```\n\u003c/details\u003e\n\n## Usage\n\nRun `buttercup` with the following options:\n\n```bash\nbuttercup [options]\n```\n\n### Options\n\n\n\n### Examples\n\n- **Play with Rofi**:\n  ```bash\n  buttercup -rofi\n  ```\n\n## Configuration\n\nAll configurations are stored in a file you can edit with the `-e` option.\n\n```bash\nbuttercup -e\n```\n\nScript is made in a way that you use it for one session of watching.\n\nYou can quit it anytime and the resume time would be saved in the history file\n\nmore settings can be found at config file.\nconfig file is located at ```~/.config/buttercup/config```\n\n## Dependencies\n- mpv - Video player (vlc support might be added later)\n- rofi - Selection menu\n- tar - Download and unzip Jackett\n\n## API Used\n- [Jackett](https://github.com/Jackett/Jackett) - To get torrents\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwraient%2Fbuttercup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwraient%2Fbuttercup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwraient%2Fbuttercup/lists"}