https://github.com/mdbraber/radiobar

macOS menubar app to listen to streaming radio
https://github.com/mdbraber/radiobar

macos menubar python radio rumps vlc

Last synced: 26 days ago
JSON representation

macOS menubar app to listen to streaming radio

• Host: GitHub
• URL: https://github.com/mdbraber/radiobar
• Owner: mdbraber
• License: mit
• Created: 2018-12-28T10:27:36.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-05-22T21:36:44.000Z (over 1 year ago)
• Last Synced: 2024-08-03T09:04:05.852Z (4 months ago)
• Topics: macos, menubar, python, radio, rumps, vlc
• Language: Python
• Homepage:
• Size: 204 KB
• Stars: 56
• Watchers: 7
• Forks: 8
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• Mac-Menubar-Megalist - RadioBar

README

        
## RadioBar

macOS menubar app to play user-defined radio stations with help from [rumps](https://github.com/jaredks/rumps) and VLC. It includes a `remote` to switch channels, on/off, pause/resume etc. Forked from [RadioBar](https://github.com/wass3r/RadioBar) by [David May](https://github.com/wass3r)

![screenshot](screenshot.png)

## Features

- ▶️ **Show _Now Playing_ information (in menubar and/or notifications)**

- ⚡ **Lightweight and fast!**

- 🖥️ **Menubar only, no Dock icon**

- 🎵 **Add any streaming URL that VLC can play**

- 💤 **Stop playing when macOS goes to sleep**

- 🕹️ **Remote control via scripts and launchers such as Alfred**

## Installation

Make sure you have `vlc` installed, e.g. using `brew cask install vlc`. Also, if you don't have Python installed, install it with `brew install python3`. Use the `master` repo of [rumps](https://github.com/jaredks/rumps) to use the `sleep()` and `wake()` events (see [PR #109](https://github.com/jaredks/rumps/pull/109))

- Adapt `channels.json` to your needs

- Check the source code to e.g. change notification settings (manual for now)

- Build the `.app` using `python setup.py py2app` (see [Development](#Development))

- Install the `.app` from the `dist/` directory

Currently no packaged `.app` is distributed because I've not yet been able to include an easy way to change / update channels. Suggestions for an easy / simple mechanism are welcome!

## Usage

- Click a channel to start streaming (a ✔ is shown in front)

- Click the current channel to pause streaming (a `-` is shown in front)

- Click "Stop" to stop streaming a channel

- "Now Playing" information shows on top of the menu and/or in menubar (truncated for long titles on smaller screens)

- Notifications are show when the "Now playing" information changes (unless it's the channel / show name)

Check `radiobar.py` source code to set options to show notifications or show nowplaying in the menubar.

Pause / resume stops streaming (but shows the channel as paused). It's not buffering radio (which didn't seem logical for live radio). You can also use the `remote.py` to automate switching channels, see below.

When macOS sleeps streaming will be stopped and you have to manually resume it (this is a feature). This only works if you're using the latest version of `rumps` (see [PR #109](https://github.com/jaredks/rumps/pull/109)).

## Remote

Use the include `remote.py` to send commands to a running RadioBar instance to change channels and switch on/off. You can also use the command as part of an Alfred workflow. `remote.py` understands the following commands:

- `n` - switch to channel _n_ in your list (starting at 1) - start playing if stopped

- `off` - stop playing raudio

- `pause` - pause playing radio (don't switch station, but stop streaming)

- `resume` | `on` - resume playing radio (start streaming again)

- `nowplaying` - output the now playing info 

- `show` - output the now playing info and trigger a notification

## Development

Make sure you have VLC installed, ie. `brew cask install vlc`.

Tested in Python 2.7.x and 3.x. To run, try:

1. `pip install -r requirements.txt`

2. `python radiobar.py`

To re-build the macOS app, run:

1. `rm -rf ./dist/ ./build/`

2. `python setup.py py2app`

You can also use the supplied `Makefile` to use `make clean`, `make build` (default) and `make install` (to copy the new .app to `/Applications`)

## Bugs

- "Now playing" integration is experimental and might not work as expected

-  Sleep / wake only works when using a [patched version](https://github.com/mdbraber/rumps) of `rumps` until [PR #109](https://github.com/jaredks/rumps/pull/109) gets merged.. This is now merged in `rumps` `master`.

- `parse_with_options` might not not be needing the second argument (`timeout`) in your version. You could remove it (not sure yet if it makes any difference). I'm still trying to implement a hook that watches for metadata changes for now playing. Tips welcome :-)

- To use it with the current VLC (>= 3.x) we need to preload the `libvlccore.dylib` as a workaround. See 

https://github.com/oaubert/python-vlc/issues/37 for more info.

## Credits

This is a fork of RadioBar built by [wass3r](https://github.com/wass3r/RadioBar/) (David May). All credits for the intial concept go to him!

## License

MIT