dl-101soundboards 1.5.3a1

Unofficial downloader for www.101soundboards.com

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-101soundboards

Usage

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 files

Alternatively, 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:

1. Go to www.101soundboards.com

2. Open the Developer Tools

3. Click Application

4. View Cookies

5. 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-music

To 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-music

Downloading 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-config

You will be asked to configure these settings on your first use of the program.