{"id":19018709,"url":"https://github.com/noahfx/lobster","last_synced_at":"2025-04-23T04:41:14.406Z","repository":{"id":62576530,"uuid":"92085689","full_name":"noahfx/lobster","owner":"noahfx","description":"Split audio files into tracks with a single command","archived":false,"fork":false,"pushed_at":"2020-10-23T22:12:00.000Z","size":45,"stargazers_count":5,"open_issues_count":4,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-11T05:06:15.927Z","etag":null,"topics":["album","audio","cli","command","command-line","downloader","ffmpeg","lobster","media","mp3","music","split","youtube","youtube-dl"],"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/noahfx.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-05-22T18:22:14.000Z","updated_at":"2021-11-03T11:18:26.000Z","dependencies_parsed_at":"2022-11-03T20:46:04.918Z","dependency_job_id":null,"html_url":"https://github.com/noahfx/lobster","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noahfx%2Flobster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noahfx%2Flobster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noahfx%2Flobster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noahfx%2Flobster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/noahfx","download_url":"https://codeload.github.com/noahfx/lobster/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250372692,"owners_count":21419720,"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":["album","audio","cli","command","command-line","downloader","ffmpeg","lobster","media","mp3","music","split","youtube","youtube-dl"],"created_at":"2024-11-08T20:09:59.712Z","updated_at":"2025-04-23T04:41:14.373Z","avatar_url":"https://github.com/noahfx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# lobster -- Split audio files into tracks with a single command\nSometimes we have found an amazing album but it is not splittedd in a proper way, just a big long song...\nwith lobster you can retrieve the long audio file (local or download audio from Youtube video) and divide\nit into mp3 files and store them into their album directory just with one simple command:\n\n```\n$ lobster --artist=\"Samsara Blues Experiment\" --album=\"Long Distance Trip\" --tracks=/tmp/tracks \\ \n           --source=youtube --input=https://www.youtube.com/watch?v=6vpOHq8bkzA --output=/tmp/\n```\nMaybe you are wondering where did you specify where to divide the track, all magic happens in the file which \nwe send as parameter to the ```--tracks``` argument.\nThe file ```/tmp/tracks``` looks as follows:\n```\nSingata Mystic Queen|00:00\nArmy of Ignorance|11:37\nFor the Lost Souls|16:12\nCenter of the Sun|26:11\nWheel of Life|39:18\nDouble Freedom|43:47\n\n```\n\nYou can find an example file under the examples directory.\n\n## Usage\n\nBut if you do not want to an input file or write all those arguments, There is\nwizard mode for you, run lobster as Wizard and forgot about all the above syntax\n\n```\n$ lobster -m wizard\n\n\u003clobster\u003e  (\\/) (°,,,°) (\\/) -- woop woop woop\n\u003clobster\u003e  Enter artist name: Gorilla Pulp  \n\u003clobster\u003e  Enter album name: Heavy Lips\n\u003clobster\u003e  Enter the source y=Youtube|l=local: [Y/l]\n\u003clobster\u003e  Enter Video URL: https://www.youtube.com/watch?v=W1vY6qVTqkM\n\u003clobster\u003e  Enter the destination directory: /tmp\n\u003clobster\u003e  Enter Number of tracks: 8\n\u003clobster\u003e  Enter Track Number 1 Name: Bless The Moon\n\u003clobster\u003e  Enter Time where Track 1 starts: (e.g: 04:20) 00:00\n\u003clobster\u003e  Enter Track Number 2 Name: In your waters\n\u003clobster\u003e  Enter Time where Track 2 starts: (e.g: 04:20) 04:34\n\u003clobster\u003e  Enter Track Number 3 Name: The Witches Twirl\n\u003clobster\u003e  Enter Time where Track 3 starts: (e.g: 04:20) 8:07\n\u003clobster\u003e  Enter Track Number 4 Name: Heavy Lips\n\u003clobster\u003e  Enter Time where Track 4 starts: (e.g: 04:20) 12:04\n\u003clobster\u003e  Enter Track Number 5 Name: Cactus Killer\n\u003clobster\u003e  Enter Time where Track 5 starts: (e.g: 04:20) 18:14\n\u003clobster\u003e  Enter Track Number 6 Name: Prey On Your Mind\n\u003clobster\u003e  Enter Time where Track 6 starts: (e.g: 04:20) 22:37\n\u003clobster\u003e  Enter Track Number 7 Name: The Low Song\n\u003clobster\u003e  Enter Time where Track 7 starts: (e.g: 04:20) 27:18\n\u003clobster\u003e  Enter Track Number 8 Name: Ape Eyes\n\u003clobster\u003e  Enter Time where Track 8 starts: (e.g: 04:20) 32:48\n\u003clobster\u003e\n information:\n artist: Gorilla Pulp\n album: Heavy Lips\n source: youtube\n input: https://www.youtube.com/watch?v=W1vY6qVTqkM\n output: /tmp\n name: Bless The Moon poisition: 1\n initial time: 00:00\n\n---------------\n name: In your waters\n poisition: 2\n initial time: 04:34\n\n---------------\n name: The Witches Twirl \n poisition: 3 \n initial time: 8:07 \n \n---------------\n name: Heavy Lips \n poisition: 4 \n initial time: 12:04 \n \n---------------\n name: Cactus Killer \n poisition: 5 \n initial time: 18:14 \n \n---------------\n name: Prey On Your Mind \n poisition: 6 \n initial time: 22:37 \n \n---------------\n name: The Low Song \n poisition: 7 \n initial time: 27:18 \n \n---------------\n name: Ape Eyes \n poisition: 8 \n initial time: 32:48 \n \n---------------\n\nIs the above information correct: [Y/n]\n\n\n```\n\n## Usage for Nerds\n\n```\n$ lobster -h\nusage: lobster [-h] --artist ARTIST --album ALBUM --tracks TRACKS --source\n               {local,youtube} --input INPUT --output OUTPUT [--format FORMAT]\n\nCut audio files with a single command\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --artist ARTIST, -ar ARTIST\n                        Name of the artist of the track this will be used to\n                        name the output directory\n  --album ALBUM, -al ALBUM\n                        Name of the album, this will be used to name the\n                        output directory\n  --tracks TRACKS, -t TRACKS\n                        File containing the information to build the tracks\n  --source {local,youtube}, -s {local,youtube}\n                        Name of the media file source\n  --input INPUT, -i INPUT\n                        Path to the source media file\n  --output OUTPUT, -o OUTPUT\n                        Path to the utput directory\n  --format FORMAT       Input media file format\n  --mode MODE, -m MODE  Launch Lobster in Wizard or Command mode,`wizard` will\n                        launch the Wizard mode, `cmd` will lauch Command mode,\n                        `cmd` is the current default\n  ```\n\nYou can install the lobster via the package manager:\n\n```\n$ sudo pip install lobster \n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoahfx%2Flobster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnoahfx%2Flobster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoahfx%2Flobster/lists"}