{"id":22374498,"url":"https://github.com/kevcui/soaper-dl","last_synced_at":"2025-04-09T07:08:27.860Z","repository":{"id":50663737,"uuid":"307089995","full_name":"KevCui/soaper-dl","owner":"KevCui","description":":tv: Soaper downloader: download TV series and movies in your terminal","archived":false,"fork":false,"pushed_at":"2025-01-17T19:58:43.000Z","size":82,"stargazers_count":72,"open_issues_count":0,"forks_count":19,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-02T06:07:01.184Z","etag":null,"topics":["bash-script","batch-download","movie-downloader","soap2day","soaper","tv-series","tv-shows"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KevCui.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":"2020-10-25T12:05:16.000Z","updated_at":"2025-03-04T05:27:50.000Z","dependencies_parsed_at":"2023-01-18T06:00:51.210Z","dependency_job_id":"71dc728d-cf5d-43ba-9791-f7bd94617c7e","html_url":"https://github.com/KevCui/soaper-dl","commit_stats":null,"previous_names":["kevcui/soap2day-dl"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KevCui%2Fsoaper-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KevCui%2Fsoaper-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KevCui%2Fsoaper-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KevCui%2Fsoaper-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KevCui","download_url":"https://codeload.github.com/KevCui/soaper-dl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247994121,"owners_count":21030050,"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":["bash-script","batch-download","movie-downloader","soap2day","soaper","tv-series","tv-shows"],"created_at":"2024-12-04T21:17:18.822Z","updated_at":"2025-04-09T07:08:27.835Z","avatar_url":"https://github.com/KevCui.png","language":"Shell","funding_links":["https://www.buymeacoffee.com/kevcui"],"categories":[],"sub_categories":[],"readme":"# soaper-dl\n\n\u003e Download TV series and movies from [Soaper](https://soaper.live/) in your terminal\n\n## Table of Contents\n\n- [Dependency](#dependency)\n- [Installation](#installation)\n- [How to use](#how-to-use)\n  - [Usage](#usage)\n  - [Example](#example)\n- [Disclaimer](#disclaimer)\n\n## Dependency\n\n- [curl](https://curl.haxx.se/download.html)\n- [jq](https://stedolan.github.io/jq/)\n- [pup](https://github.com/EricChiang/pup)\n- [fzf](https://github.com/junegunn/fzf)\n- [ffmpeg](https://ffmpeg.org/download.html)\n\n## How to use\n\n### Usage\n\n```\nUsage:\n  ./soaper-dl.sh [-n \u003cname\u003e] [-p \u003cpath\u003e] [-e \u003cnum1,num2,num3-num4...\u003e] [-l] [-s] [-d]\n\nOptions:\n  -n \u003cname\u003e               TV series or Movie name\n  -p \u003cpath\u003e               media path, e.g: /tv_XXXXXXXX.html\n                          ingored when \"-n\" is enabled\n  -e \u003cnum1,num3-num4...\u003e  optional, episode number to download\n                          e.g: episode number \"3.2\" means Season 3 Episode 2\n                          multiple episode numbers seperated by \",\"\n                          episode range using \"-\"\n  -l                      optional, list video or subtitle link without downloading\n  -s                      optional, download subtitle only\n  -d                      enable debug mode\n  -h | --help             display this help message\n```\n\n### Example\n\n- Search TV series or movies name and select the right one in `fzf`:\n\n```bash\n$ ./soaper-dl.sh -n 'game of'\n  [/movie_mlkW68VGba.html][2023] The Game of Crowns: The Tudors\n  [/movie_nXDEY29Dml.html][2023] Game of Love\n  [/movie_LwD8MEPg9a.html][2023] Game of Deceit\n  [/movie_zrYg3nbDL1.html][2022] A Game of Secrets\n  [/movie_wY4GQ0Wgbe.html][2023] Game of Love\n\u003e [/tv_34OGB6G6Zl.html][2011-04-17] Game of Thrones\n```\n\n- If the media URI path is known, for instance, `/tv_34OGB6G6Zl.html` in the previous example is the path for `Game of Thrones`:\n\n```bash\n$ ./soaper-dl.sh -p /tv_34OGB6G6Zl.html\n...\n[2.1] 1.Winter is Coming\n[2.2] 2.The Kingsroad\n[2.3] 3.Lord Snow\n[2.4] 4.Cripples, Bastards, and Broken Things\n[2.5] 5.The Wolf and the Lion\n[2.6] 6.A Golden Crown\n[2.7] 7.You Win or You Die\n[2.8] 8.The Pointy End\n...\nWhich episode(s) to download:\n```\n\n- Download `Friends S01E01`:\n\n```bash\n$ ./soaper-dl.sh -p /tv_YxAgjOVGEL.html -e 1.1\n[INFO] Downloading video 1.1...\n```\n\nThe downloaded video will be present in the folder `~/\u003cmedia_name\u003e/`\n\n- Support batch downloads: download `Friends S01E01` to `S01E05`:\n\n```bash\n$ ./soaper-dl.sh -p /tv_aTo2OTs.html -e 1.1,1.2,1.3,1.4,1.5\n[INFO] Downloading video 1.1...\n...\n[INFO] Downloading video 1.2...\n...\n[INFO] Downloading video 1.3...\n...\n[INFO] Downloading video 1.4...\n...\n[INFO] Downloading video 1.5...\n...\n```\n\nOR using episode range:\n\n```bash\n$ ./soaper-dl.sh -p /tv_aTo2OTs.html -e 1.1-1.5\n[INFO] Downloading video 1.1...\n...\n[INFO] Downloading video 1.2...\n...\n[INFO] Downloading video 1.3...\n...\n[INFO] Downloading video 1.4...\n...\n[INFO] Downloading video 1.5...\n...\n```\n\n:warning: The range option only works when the season number is the same. To download episodes in different seasons, for example: `... -e 1.1-1.5,2.2-2.8,3.1-3.5`\n\n- Display only video link, used to pipe into `mpv` or other media player:\n\n```bash\n$ mpv \"$(./soaper-dl.sh -p /tv_YxAgjOVGEL.html -e 1.1 -l)\"\n```\n\n- Download subtitle only\n\n```\n./soaper-dl.sh -n 'game of thrones' -s\n```\n\n- Customize subtitle language\n\n```bash\nSOAPER_SUBTITLE_LANG=fr ./soaper-dl.sh -n 'game of thrones'\n```\n\n## Disclaimer\n\nThe purpose of this script is to download TV series episodes and movies in order to watch them later in case when Internet is not available. Please do NOT copy or distribute downloaded materials to any third party. Watch them and delete them afterwards. Please use this script at your own responsibility.\n\n---\n\n\u003ca href=\"https://www.buymeacoffee.com/kevcui\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-orange.png\" alt=\"Buy Me A Coffee\" height=\"60px\" width=\"217px\"\u003e\u003c/a\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevcui%2Fsoaper-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevcui%2Fsoaper-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevcui%2Fsoaper-dl/lists"}