This release is a pre-release and may not be stable for production use.
dl-101soundboards
An unofficial downloader for https://www.101soundboards.com/boards/ URLs.
Dependencies
Python 3.8 or higher
FFmpeg (add this to your system PATH)
Installation
$ pip install dl-101soundboardsUsage
Use the shell command dl-101soundboards with the URLs as arguments.
$ dl-101soundboards https://www.101soundboards.com/boards/685667-windows-95-video-game-music https://www.101soundboards.com/boards/646953-spy-vs-spy-video-game-music
Fetching "https://www.101soundboards.com/boards/685667"....
Fetching "Windows 95 - Video Game Music" (8 sounds)....
Downloaded 8 sounds to "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/untrimmed"
Trimming sound files....
Exported 8 FLAC files to "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/flac"
Adding metadata to /home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/flac/*.flac....
Tagged 8 FLAC files
Removing original downloads....
Removed "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/untrimmed"
Fetching "https://www.101soundboards.com/boards/646953"....
Fetching "Spy vs. Spy - Video Game Music" (10 sounds)....
Downloaded 10 sounds to "/home/gitchasing/Video Game OSTs/Spy vs. Spy - Video Game Music/646953/untrimmed"
Trimming sound files....
Exported 10 FLAC files to "/home/gitchasing/Video Game OSTs/Spy vs. Spy - Video Game Music/646953/flac"
Adding metadata to /home/gitchasing/Video Game OSTs/Spy vs. Spy - Video Game Music/646953/flac/*.flac....
Tagged 10 FLAC files
Removing original downloads....
Removed "/home/gitchasing/Video Game OSTs/Spy vs. Spy - Video Game Music/646953/untrimmed"By default, dl-101soundboards exports separate, trimmed files from the original downloads, then deletes said downloads. To keep the original, unedited files with the filtered ones, simply use the --no-delete flag.
$ dl-101soundboards --no-delete https://www.101soundboards.com/boards/685667-windows-95-video-game-music
Fetching "https://www.101soundboards.com/boards/685667"....
Fetching "Windows 95 - Video Game Music" (8 sounds)....
Downloaded 8 sounds to "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/untrimmed"
Trimming sound files....
Exported 8 FLAC files to "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/flac"
Adding metadata to /home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/flac/*.flac....
Tagged 8 FLAC filesAlternatively, if you wish to leave the sounds untrimmed, use the --no-trim flag.
$ dl-101soundboards --no-trim https://www.101soundboards.com/boards/685667-windows-95-video-game-music
Fetching "https://www.101soundboards.com/boards/685667"....
Fetching "Windows 95 - Video Game Music" (8 sounds)....
Downloaded 8 sounds to "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/untrimmed"Exports
Downloads only come as MP3s, but exports support whatever FFmpeg supports.
Run ffmpeg -formats to view available (de)muxers for your version of FFmpeg.
To specify the export format(s), use the -f or --format flag:
$ dl-101soundboards -f WAV AIFF TTA https://www.101soundboards.com/boards/685667-windows-95-video-game-music
Fetching "https://www.101soundboards.com/boards/685667"....
Fetching "Windows 95 - Video Game Music" (8 sounds)....
Downloaded 8 sounds to "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/untrimmed"
Trimming sound files....
Exported 8 WAV files to "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/wav"
Exported 8 AIFF files to "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/aiff"
Exported 8 TTA files to "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/tta"
Adding metadata to /home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/aiff/*.aif....
Tagged 8 AIFF files
Adding metadata to /home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/tta/*.tta....
Tagged 8 TTA files
Adding metadata to /home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/wav/*.wav....
Tagged 8 WAV files
Removing original downloads....
Removed "/home/gitchasing/Video Game OSTs/Windows 95 - Video Game Music/685667/untrimmed"Beware that exporting lossy formats will necessarily shed quality, due to the sample-precise trimming operations made by the program.
Further note that dl-101soundboards only supports metadata-tagging for some lossless formats (Audio Interchange File Format (AIFF), Free Lossless Audio Codec (FLAC), True Audio (TTA), Waveform Audio File Format (WAV(E)), and WavPack (WV)). Metadata-tagging for other lossless formats will be considered in future versions.
Known Issues
Cloudflare
101soundboards seems to utilise Cloudflare in order to keep webscrapers (like this one) off its site. To bypass Cloudflare, you will need a cf_clearance token. For Chrome, take the following steps:
Go to www.101soundboards.com
Open the Developer Tools
Click Application
View Cookies
Copy the value of the cf_clearance cookie under https://www.101soundboards.com
To use a cf_clearance token, use the -t or --token flag:
$ dl-101soundboards.com -t [cf_clearance token] [url]OSError
Under your downloads directory, dl-101soundboards creates a subdirectory for each URL, based on the board title. Sometimes this board title makes for an incompatible folder name. E.g., on Windows:
$ dl-101soundboards https://www.101soundboards.com/boards/644430-xenoblade-chronicles-x-xenoblade-cross-zenobureidokurosu-video-game-musicTo circumvent this, simply use the -o or --output flag:
$ dl-101soundboards -o "Xenoblade Chronicles X Soundtrack" https://www.101soundboards.com/boards/644430-xenoblade-chronicles-x-xenoblade-cross-zenobureidokurosu-video-game-musicDownloading to the Working Directory
$ dl-101soundboards -wd <urls>Configuration
To configure your downloads directory and user agent, use the -e or --edit-config flag.
$ dl-101soundboards --edit-configYou will be asked to configure these settings on your first use of the program.
1 maintainer
Metadata
1 maintainer
Release files for dl-101soundboards 1.5.3a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dl_101soundboards-1.5.3a1.tar.gz | 48.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dl_101soundboards-1.5.3a1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 83.7 kB
Release files / dl_101soundboards-1.5.3a1.tar.gz
| Download URL | dl_101soundboards-1.5.3a1.tar.gz |
|---|---|
| Size | 48.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4f760931bf69da4bd35935715531e8b63f8271b27ef79405c6ad2eb7c9d51019
|
|
BLAKE2b-256 checksum How to use checksums |
e0b93a4fbb95187956adcbd39550e7d0d338445328a183976fa99288eb18506a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.3
|
Release files / dl_101soundboards-1.5.3a1-py3-none-any.whl
| Download URL | dl_101soundboards-1.5.3a1-py3-none-any.whl |
|---|---|
| Size | 35.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
10858829e4f15e291408d4bdd7d1c0e27c18571f93ae9f905fa7b21153d71574
|
|
BLAKE2b-256 checksum How to use checksums |
21c8ca4541b009d6a8acc3dcad91d3799fc6342b7e94c32250571ea80701d5fd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.3
|
