• Remixer
  • How to run
    • Compiled executable
    • Manual compiling
      • System requirements
      • Compiling
    • Docker container
    • Or use Hyperstream!
  • Usages
    • As a CLI
  • Contribution
  • License
  • Development stack
  • Special thanks

Remixer

Note

No clue what Hyperstream is? Welcome to the general README!

Remixer is the heart of Hyperstream, an SFX toolkit, which alters songs' speed, can add reverb, and some more effects! Even though Remixer is a part of Hyperstream ecosystem, it can be used as a standalone CLI tool.

Important

Contributors, may I have your attention, please! Hyperstream offers a huge spectrum of technologies, including C++, PHP (Laravel), Vue, and Java! Feel free 'n brave to explore and write code for available issues! There is a tiny list of rules to consider when contributing though, please, check out our Hyperstream contribution guide.

How to run

You can build and run Remixer via 3 different ways. Choose the most comfortable, and easiest to perform. If something goes not the way it should, fall back to any other option.

Note

Obviously, you may install Remixer globally. Just move the installer into any of /bin directories, or add build directory to $PATH. After that, you can use HyperstreamRemixer command globally

Compiled executable

I have compiled Remixer on Linux. Download one to use from the releases page.

Manual compiling

On other platforms, you can compile the project manually. Follow the following step-by-step guide:

System requirements

• clang as a compiler
• cmake as a building toolset
• vcpkg as a package manager

Compiling

Just run build script in the root:

cd hyperstream-remixer/
./build.sh

After building, a ready-to-run executable can be found as ./build/HyperstreamRemixer

Docker container

Remixer can be run containerized in Docker. To instantiate it:

docker build -t hyperstream-remixer
docker run -it --rm hyperstream-remixer

Warning

On some systems, Docker CLI requires super user privileges. Just prefix commands above with sudo.

Or use Hyperstream

Yea! Instead of manually installing just a part of Hyperstream, it would be a nice idea to install whole Hyperstream, since you can search for music via a website page, save songs you like, remix them right there, and binge-listen them! About deploying Hyperstream, check the dedicated guide.

Caution

Even considering the fact that Hyperstream can be self-hosted, I strictly disallow any commercial usage of Hyperstream, or Remixer.

Usages

As a CLI

Use Remixer as a CLI tool to add effects to your mp3's! This command adds +20% to speed, adds reverb, crackle, low pass, and white noise:

Note

Use HyperstreamRemixer --help for available options.

HyperstreamRemixer --input "Omnia, Ira - The Fusion.mp3" --speed 1.2 --reverb 0.4 --noise 0.4 --crackle 0.001 --lowpass 0.2 --output "Omnia, Ira - The Fusion (Speedcore Remix).mp3"

Tip

If you omit the --output option, a remixed song will be played instead of outputting it to a file.

Contribution

Remixer welcomes both amateur, and professional programmers!

Important

Before contributing, see contribution rules.

To see available tasks to do, bugs to fix, and features to implement, please, check out open issues.

Tip

If you are not a C++ developer, don't leave now! Hyperstream is a large platform with many micro services. Java, PHP, Laravel, Vue, web development - welcome to choose!

License

Remixer, like any other Hyperstream part, is licensed under MIT. Read about MIT in the LICENSE file.

Development stack

Remixer uses C++23 as a main programming language. In addition, it utilizes the following tools, and libraries:

• vcpkg
• mp3dec
• mp3lame
• sdl2
• argparse
• Dear ImGui

Special thanks

Special thanks to many websites that described audio processing! Sadly I haven't written the links down. Huge thanks to all the contributors of argparse! You made a great job! Definitely gonna use it in other CLI projects.

---

Copyright (c) 2026 Anatoly Frolov (anafro). All Rights Reserved.
contact@anafro.ru