14 releases (5 breaking)

0.7.0 Aug 26, 2024
0.6.1 Jul 13, 2024
0.4.0 May 21, 2024
0.3.0 Mar 24, 2024
0.1.6 Jan 29, 2024

#377 in Audio

Download history 170/week @ 2024-08-26 19/week @ 2024-09-16 48/week @ 2024-09-23 4/week @ 2024-09-30 2/week @ 2024-10-14 110/week @ 2024-12-02

110 downloads per month

MIT license

460KB
1K SLoC

Rust 729 SLoC // 0.0% comments Swift 377 SLoC // 0.1% comments

lonelyradio Music Streamer

Shuffles through your XSPF playlists or your entire library.

Decodes audio streams using symphonia (supported decoders and demuxers)

Streams music using FLAC, ALAC, Vorbis or raw PCM on client’s requests.

Install server

cargo install --git https://github.com/ivabus/lonelyradio --tag 0.7.0 lonelyradio

Run

lonelyradio <MUSIC_FOLDER>

All files (recursively) will be shuffled and played back. Log will be displayed to stdout.

Look into --help for detailed info

Playlists

Specify a directory with playlists with --playlist-dir. lonelyradio will scan them on startup and play them on clients’ requests.

Only the <location> and (playlist's) element would be used and only file:// is supported.

Clients

monoclient-x

monoclient-x is a SwiftUI player for lonelyradio for iOS/iPadOS/macOS

Build
  1. Build monolib with xcframework
  2. Build monoclient-x using Xcode or xcodebuild

monoclient-s

monoclient-s is a GUI player for lonelyradio built with Slint

Install
cargo install --git https://github.com/ivabus/lonelyradio --tag 0.7.0 monoclient-s

You may need to install some dependencies for Slint.

Desktop integration will be added later.

monoclient

monoclient is a CLI player for lonelyradio that uses monolib

Install monoclient
cargo install --git https://github.com/ivabus/lonelyradio --tag 0.7.0 monoclient

Usage

monoclient <SERVER>:<PORT>

Look into --help for detailed info on usage.

Other things

monoloader is a tool that allows you to download individual audio tracks from lonelyradio-compatible servers.

monolib provides a C API compatible with lonelyradio for creating custom clients.

The full protocol specification will be available later. If you would like to learn more about it now, please refer to the monolib.

monolib API stability

As lonelyradio has not yet reached its first major release, the API may (and will) break at any point.

License

lonelyradio, monolib and monoclient, as well as all other crates in this repository, are licensed under the terms of the MIT license.

Dependencies

~19–30MB
~456K SLoC