| Name | Auto-DLP JSON |
| Version |
2024.12.39
JSON |
| download |
| home_page | None |
| Summary | A simple and lightweight system for downloading and managing youtube playlists and songs (based on yt-dlp) |
| upload_time | 2024-12-15 17:58:18 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| keywords |
youtube
dlp
music
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Auto-DLP
A simple command-line utility for automating the process of downloading songs using yt-dlp and sorting them into folders. Can also push files to android devices.
The philosophy of this tool is to download songs and lay them out beautifully in the filesystem, this means that there are a lot of features to get the names of files, folders, etc. correct.
## Getting Started
Use ```pipx install auto-dlp``` to install the command directly or use
```pip install auto-dlp``` to install the module and run it using ```<Your python installation> -m auto_dlp```.
```Your python installation``` is usually one of ```python```, ```python3``` or ```py```.
In the command line try ```auto-dlp -h```. If this runs without an error, you have successfully installed the tool.
Now choose a directory in which you would like your music to be stored, there run the command ```auto-dlp --create-example .```. This will create an example ```auto-dlp.json``` file which will download some songs and playlists. For the more advanced features of this tool, read the following section.
## Advanced Features
### Pushing the files to Android devices
First you must configure the feature in your `auto-dlp.json` file:
```jsonc
{
// Where various files are cached
"config dir": "~/.local/state/youtube-downloader/",
// This is where your artists go
"artists": {
...
},
// This is the important line
// adb stands for Android-Debug-Bridge and
// is an offial tool for debugging (and copying files)
"adb push": true
// The following options are optional
// This option can be used to restart the adb service every
// time the program is executed, use this if it is making problems
// "restart adb": true
// Where the files should be copied to
// "adb push dir": "/sdcard/Music"
// Additional folders that should be copied to your device
// By default Auto-DLP only copies the artist's folders
// "extra adb folders": [...]
}
```
Then you must plug your phone into your Laptop with the phone's debug mode enabled. Now just start `auto-dlp` normally and it should copy the files over automatically.
### Heeelp!! I get errors on certain playlists/songs
For this there is two configuration options:
```jsonc
{
// Where various files are cached
"config dir": "~/.local/state/youtube-downloader/",
// This is where your artists go
"artists": {
...
},
// With this entry you can forcefully rename songs that
// are automatically downloaded as part of a playlist.
// This is for example a fix for the problem of empty names.
"rename": {
"<some name>": "<a valid name>",
...
},
// This key is for playlists that just don't want to be downloaded
// and make the program throw the following error:
// "The Youtube Api returned the same result twice"
// Ironically this is (so far) only on official Youtube Playlists
"fragile playlists": [
"RDCLAK5uy_lp8LtelM9GiSwRFGGQjctKaGoHcrgQVEU",
...
]
}
```
### The names don't look like I want them to
The names for songs in playlists are simply those entered
on Youtube. These are, however, sometimes shit.
For this there is the following configuration options:
```jsonc
{
// Where various files are cached
"config dir": "~/.local/state/youtube-downloader/",
// This is where your artists go
"artists": {
...
},
// This entry specifies this that are searched for in names
// and removed. Case is ignored and the values are treated as
// python regexes
"name rules": [
// This value will remove all text from titles that contain a
// '(official' followed by anything and then another ')'
// i.e '(Official Music Video)'
"\\(official.*\\)",
...
],
// This entry is somewhat meta. It is intented to make writing
// regexes for "name rules" easier. It is a simple find and replace
// system.
// In the following example the string "<" is replaced by something
// that matches '[' or '('
// The strings are replaced in the "name rules"
// For example we could write the above rule as
// "<official.*>"
// Now it would also match (and remove) '[Official Video]'
"rule macros": {
"<": "[\\[\\(]",
">": "[\\]\\)]",
...
}
}
```
Raw data
{
"_id": null,
"home_page": null,
"name": "Auto-DLP",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "Youtube, dlp, music",
"author": null,
"author_email": "Vorak <5m9mnf37q@mozmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c3/8d/2d897fa5bb29cbd970fdafdd79272f0b220e80887f69819bd1dbe5d36d8a/auto_dlp-2024.12.39.tar.gz",
"platform": null,
"description": "# Auto-DLP\nA simple command-line utility for automating the process of downloading songs using yt-dlp and sorting them into folders. Can also push files to android devices.\n\nThe philosophy of this tool is to download songs and lay them out beautifully in the filesystem, this means that there are a lot of features to get the names of files, folders, etc. correct.\n\n## Getting Started\nUse ```pipx install auto-dlp``` to install the command directly or use\n```pip install auto-dlp``` to install the module and run it using ```<Your python installation> -m auto_dlp```.\n```Your python installation``` is usually one of ```python```, ```python3``` or ```py```.\n\nIn the command line try ```auto-dlp -h```. If this runs without an error, you have successfully installed the tool.\n\nNow choose a directory in which you would like your music to be stored, there run the command ```auto-dlp --create-example .```. This will create an example ```auto-dlp.json``` file which will download some songs and playlists. For the more advanced features of this tool, read the following section.\n\n## Advanced Features\n\n### Pushing the files to Android devices\n\nFirst you must configure the feature in your `auto-dlp.json` file:\n```jsonc\n{\n // Where various files are cached\n \"config dir\": \"~/.local/state/youtube-downloader/\",\n // This is where your artists go\n \"artists\": {\n ...\n },\n // This is the important line\n // adb stands for Android-Debug-Bridge and\n // is an offial tool for debugging (and copying files)\n \"adb push\": true\n\n // The following options are optional\n // This option can be used to restart the adb service every\n // time the program is executed, use this if it is making problems\n // \"restart adb\": true\n // Where the files should be copied to \n // \"adb push dir\": \"/sdcard/Music\"\n // Additional folders that should be copied to your device\n // By default Auto-DLP only copies the artist's folders\n // \"extra adb folders\": [...]\n}\n```\n\nThen you must plug your phone into your Laptop with the phone's debug mode enabled. Now just start `auto-dlp` normally and it should copy the files over automatically.\n\n### Heeelp!! I get errors on certain playlists/songs\n\nFor this there is two configuration options:\n```jsonc\n{\n // Where various files are cached\n \"config dir\": \"~/.local/state/youtube-downloader/\",\n // This is where your artists go\n \"artists\": {\n ...\n },\n // With this entry you can forcefully rename songs that\n // are automatically downloaded as part of a playlist.\n // This is for example a fix for the problem of empty names.\n \"rename\": {\n \"<some name>\": \"<a valid name>\",\n ...\n },\n // This key is for playlists that just don't want to be downloaded\n // and make the program throw the following error:\n // \"The Youtube Api returned the same result twice\"\n // Ironically this is (so far) only on official Youtube Playlists\n \"fragile playlists\": [\n \"RDCLAK5uy_lp8LtelM9GiSwRFGGQjctKaGoHcrgQVEU\",\n ...\n ]\n}\n```\n\n### The names don't look like I want them to\n\nThe names for songs in playlists are simply those entered\non Youtube. These are, however, sometimes shit.\n\nFor this there is the following configuration options:\n```jsonc\n{\n // Where various files are cached\n \"config dir\": \"~/.local/state/youtube-downloader/\",\n // This is where your artists go\n \"artists\": {\n ...\n },\n // This entry specifies this that are searched for in names\n // and removed. Case is ignored and the values are treated as\n // python regexes\n \"name rules\": [\n // This value will remove all text from titles that contain a\n // '(official' followed by anything and then another ')'\n // i.e '(Official Music Video)'\n \"\\\\(official.*\\\\)\",\n ...\n ],\n // This entry is somewhat meta. It is intented to make writing\n // regexes for \"name rules\" easier. It is a simple find and replace\n // system.\n // In the following example the string \"<\" is replaced by something\n // that matches '[' or '('\n // The strings are replaced in the \"name rules\"\n // For example we could write the above rule as\n // \"<official.*>\"\n // Now it would also match (and remove) '[Official Video]'\n \"rule macros\": {\n \"<\": \"[\\\\[\\\\(]\",\n \">\": \"[\\\\]\\\\)]\",\n ...\n }\n}\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "A simple and lightweight system for downloading and managing youtube playlists and songs (based on yt-dlp)",
"version": "2024.12.39",
"project_urls": null,
"split_keywords": [
"youtube",
" dlp",
" music"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a3d939b3f7548de0875dc82c0d1879dc9c6312759daf20c0e1dfb7242e08e378",
"md5": "27c53c5ccba1945443cb1d7b9c02ad52",
"sha256": "b2105819d77201bad3fe23cf7fb71b3d2b484fb54bfe157474fa7755322d11b7"
},
"downloads": -1,
"filename": "auto_dlp-2024.12.39-py3-none-any.whl",
"has_sig": false,
"md5_digest": "27c53c5ccba1945443cb1d7b9c02ad52",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 23097,
"upload_time": "2024-12-15T17:58:15",
"upload_time_iso_8601": "2024-12-15T17:58:15.115957Z",
"url": "https://files.pythonhosted.org/packages/a3/d9/39b3f7548de0875dc82c0d1879dc9c6312759daf20c0e1dfb7242e08e378/auto_dlp-2024.12.39-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c38d2d897fa5bb29cbd970fdafdd79272f0b220e80887f69819bd1dbe5d36d8a",
"md5": "5ca9613562219f2dfc1e7da0290d34e0",
"sha256": "89087cab728c98ce5dba5102bbc466a9db8274f6a787241e62780de98eb73833"
},
"downloads": -1,
"filename": "auto_dlp-2024.12.39.tar.gz",
"has_sig": false,
"md5_digest": "5ca9613562219f2dfc1e7da0290d34e0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 25865,
"upload_time": "2024-12-15T17:58:18",
"upload_time_iso_8601": "2024-12-15T17:58:18.418726Z",
"url": "https://files.pythonhosted.org/packages/c3/8d/2d897fa5bb29cbd970fdafdd79272f0b220e80887f69819bd1dbe5d36d8a/auto_dlp-2024.12.39.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-15 17:58:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "auto-dlp"
}
