"In theory, theory and practice are the same. In practice, they’re not." - Yoggi Berra
This project is being actively updated and support/feedback from the community is much appreciated. You can share your issues and ideas in the maraud Issue Tracker.
You can also check out my youtube channel where i share the journey of marauds development.
| The Pitch - Installation - Quick Start Guide - Documentation |
|---|
| How it works - Cross-Platform Support - Releases & Changelogs - Gallery - Credits - License |
maraud is a free, open-source, and highly customizable command line tool for downloading songs in bulk from SoundCloud and YouTube. It is optimized for speed, efficiency, and controlled workflows, allowing users to queue, manage, and fetch large collections of music with minimal friction.
maraud is designed to enable fast, automated iterations of downloading while empowering power-users to create tailored workflows. It favors simplicity, customization, and performance over unnecessary complexity. Unlike higher-level GUI-based downloaders, maraud is laser-focused on being scriptable, extensible, and predictable. Features such as graphical frontends, auto-recommendations, or heavy external integrations are intentionally excluded to keep the tool lean and maintainable.
- Minimize setup and maintenance overhead
- Provide consistent, predictable results
- Simple interface with high customizability through configuration files
- Optimized for bulk operations and efficient downloads
- Portable, lightweight, and dependency-minimized
- Easy to hack, extend, and integrate into custom workflows
- Built for performance and tested against real-world bulk usage
maraud is based on a cli-interface and intended for primary usage in the operating system terminal. This installation guide will focus on installing maraud to the Windows command-prompt and Mac terminal.
If you want to include this program as an internal api in your own program, you can read the installation guide in the official maraud documentation.
maraud is just a single executable that is completly standalone and needs minimal dependencies. You can find the newest release build but also legacy versions in the GitHub Release section.
- Download maraud in your desired configuration depending on your architecture and operating system and place the file somewhere on your drive.
You now need to export the application path to your system environment variables. This depends on the operating system you are using.
- On Windows, you can add the application path to the
PATHenvironment variables using Environment Variables. If you are using a Mac, you can use this command to add maraud to the environment variables. On a Mac, depending on where you put the executable, there is a different way of adding it to the PATH variales. This can be done by creating a symlink to the maraud executable.
chmod +x ~/Desktop/maraud
sudo ln -s ~/Desktop/maraud /usr/local/bin/maraud
To verify that maraud is globally accessable by the terminal, type:
maraud --version
maraud is a very complex and deeply customizable program. For further information, see docs.md. This section of the README will only focus on the easiest way of downloading a file from a URL.
This command will download an mp3 file from the provided Weblink and save it to the provided destination in a .wav format.
maraud -u <URL> -o <OUTPUT_PATH> -f wav
See docs.md for a fully detailed guide and feature explanation including tutorials (WIP).
maraud uses the yt-dlp backend to fetch sound files from streaming services like YouTube and SoundCloud, verify them, sort them and convert them to a useable mp3 or wav format using ffmpeg.
maraud should work just fine for both Windows and Mac operating systems because the code base doesnt rely on any system api specific commands only available on either windows or mac.
See changelog.txt for changelogs. Reading the changelogs is a good way to keep up to date with the things maraud has to offer, and maybe will give you ideas of some features that you've been ignoring until now!
Coming soon!
Developed by Kian Schmalzl and inspired by many talented people.
Kian: "I needed a program that was capable of downloading songs from multiple streaming services at the same time while being to minimalistic it seems like it was developed on the fly. But it also needed to be customizable in a way I could use it for many different cases. I just wrote those ideas down on paper, thought of a fitting name and came up with: maraud."
maraud uses yt-dlp as a file downloading backend. maraud uses ffmpeg for file conversion.
maraud is licensed under the MIT License. See LICENSE.txt for more information.