Skip to content

t3brightside/miliza_server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Miliza

Miliza is a standalone streamer software. It can play Tidal streams and internet radio.
Run it in your media server and access over web interface in local network.

Integrates with the Tidal through EbbLabs/python-tidal API.
Finding internet radios throguh radio-browser.info and plays from direct links.

Try it out on your Raspberry PI or some other ARM64 or x86_64 Linux machine.

⚠️ Disclaimer

This project has no relation to the official Tidal music app, nor is it endorsed by Tidal in any way.

As-Is Software: This software is free to use but comes with no warranty or guarantee of functionality on your personal system. Use it at your own risk.

For now, this is an Alpha state software. It's not meant to be 100% solid and have all the functionality one can wish for.
Discussion over functionality, features, and bugs: https://github.com/t3brightside/miliza_server/issues

🔽 Download

This repository is for documentation and bug tracking only.
Binary downloads are available on the website: https://miliza.eu

✨ Features

For now there is two compiled versions. One compiled on ARM64 Debian and other on x86_64 Ubuntu.

Being a personal hobby project the releases are fairly irregular and versioned just by the date and time.

  • Standalone Binary: Compiled into a single executable for easy deployment.
  • Tidal Integration: Access your favorite Tidal tracks, playlists, and albums. Hi-res playback.
  • Online radio stations Search stations, and listen to direct stream links.
  • Hardware Audio: Direct ALSA output and Bluetooth routing support.
  • Web UI: Accessible via web browser in local network (Chrome only for now).

Selected features:

  • Hi-Res playback.
  • Tidal search with search history.
  • Show and add media from personal Tidal database, albums, artists, playlists, mixes, etc.
  • Share, tracks, albums, lists, etc. Find content using sharelinks.
  • Basic queue handling.
  • Lyrics.
  • 10-band EQ.
  • Technical file and playback information.
  • Selectable DAC, bluetooth and browser output.
  • Selectable volume control for DAC hardware.
  • Bluetooth control, power, pairing. Multidevice connectivity.

📱 Screens

🛠️ 1. System Prerequisites

Even though Miliza is packaged as a standalone binary, it relies on system-level C-libraries for audio playback and Bluetooth management. GStreamer, ALSA, and BlueZ must be installed on the host system before running the app.

The following is not a complete guide but may help getting it run.

Commands to install the required dependencies on a Debian/Ubuntu-based system:

export PYTHONIOENCODING=utf-8

sudo apt install libgirepository-2.0-0
sudo apt install alsa-utils bluez bluez-tools
sudo apt install gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-alsa
sudo apt install liborc-0.4-0 liborc-0.4-dev libasound2-plugins gstreamer1.0-plugins-bad gstreamer1.0-libav

Bluetooth Configuration

To allow Miliza to manage Bluetooth devices, ensure the Bluetooth service is running and your user has the correct permissions:

# Enable and start the Bluetooth service
sudo systemctl enable --now bluetooth

# Add your user to the bluetooth group
sudo usermod -aG bluetooth $USER

# Restart the service to apply changes
sudo systemctl restart bluetooth

(Note: You may need to log out and log back in for the group changes to take effect).


🚀 2. Running Miliza

Since Miliza is compiled into a single executable, you don't need to install Python or set up virtual environments on the target machine.

There are 2 binaries available for now.

  • x86_64 compiled on Ubuntu
  • aarch64 compiled on Debian.
  1. Run the server:

    ./miliza_server_alpha_arm64_202603141200
  2. Access the Interface: Once the backend starts, open a web browser and navigate to:

    http://IP-ADDRESS:5000
    

🔈 Usage

Go to Settings. Auth for Tidal. Set the output hardware and try it out.

📝 License

This software is provided free of charge for personal use only.

The software is distributed as-is, without any warranty of any kind. By using this software, you acknowledge that you do so at your own risk, and the author assumes no liability for any damages, legal issues, or other consequences arising from its use.

Commercial use, selling, or redistributing this software in any form is not permitted.

About

Music streaming with unofficial Tidal support for Linux.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors