Skip to content

rybr-dev/radio-paradise-macos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
icon_128x128

Radio Paradise for macOS

Radio Paradise Menu Bar App Swift License

A native macOS menu bar app for streaming Radio Paradise, commercial-free listener-supported Internet radio curated by real human beings.

Supported on macOS 10.13 (Ventura) and higher (macOS 14 Sonoma required for Apple Music integration).

This app is not published or supported by Radio Paradise, and is created with permission (and love and respect) by the RP fans at rybr.dev. Please support Radio Paradise at https://radioparadise.com/support.

Download

Download the latest release. Open the .zip file and drag the revealed Radio Paradise app to your Applications folder, then launch it and enjoy the music!

Pretty picture

2

Features

  • Streaming music: Stream the 320kbps AAC stream of Radio Paradise's Main Mix
  • Menu bar interface: An unobtrusive menu bar player with now playing info and other helpful utilities
  • Album artwork: Shows the album art of the currently playing song. Hover to view the high-res version.
  • Apple Music integration: Add songs to a special Apple Music playlist
  • Song sharing: Share songs you love with friends via links to Radio Paradise
  • macOS media controls: Supports play/pause from keyboard media keys and the Now Playing view

Requirements

  • macOS 13.0 (Ventura) or later
  • Xcode 15.0 or later (for building)

Contribute

Contributions to the project are welcome. Make changes on a fork and submit a PR to this repo.

Building from Source

  1. Clone this repository

  2. Open in Xcode

    open RP.xcodeproj
  3. Configure signing:

    • Select the "RP" target in Xcode
    • Go to "Signing & Capabilities"
    • Select your Apple Developer Team
    • Update the Bundle Identifier to use your own domain
  4. Build and run:

    • Press Cmd+R or click the Run button in Xcode

Architecture

Written fully in Swift. Core classes:

  • RadioPlayer: Handles audio streaming and now playing data
  • StatusMenuController: Manages the menu bar interface
  • MusicService: Apple Music API integration and song/playlist management
  • NotificationService: System notifications

Dependencies

with special thanks to their owners and contributors.

TODO

Things that would be cool to add:

  • Station selector: Stream other stations on Radio Paradise. This means researching and managing the other song feeds as well. DONE!
  • Limited bandwidth fallback: The 320kbps stream is buttery but in case of slow connections, it might be helpful to downshift to lower-bandwidth streams.

License

This project is licensed under the GPLv3 License - see the LICENSE file for details.

Special Thanks

This app is an ode to Radio Paradise. Thank you for decades of incredible music.

Support

Please support independent radio and the ongoing work of Radio Paradise at https://radioparadise.com/support.

If you encounter any issues or have feature requests with this app, please open an issue on GitHub.

If you'd like to donate to the ongoing development of this app, you can buy us a coffee or sponsor us via GitHub. You're also welcome to submit contributions via PR.

About

Radio Paradise for Mac is a lightweight macOS menu bar app that lets you enjoy the iconic Main Mix stream from Radio Paradise, the beloved listener-supported internet radio station known for its eclectic, human-curated music.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors

Languages