https://github.com/unclelukie/jaybird
a discord rich triple j/double j/unearthed cli player
https://github.com/unclelukie/jaybird
abcradio cli discord-rich-presence dotnet doublej music player radio triplej unearthed vlc
Last synced: about 1 month ago
JSON representation
a discord rich triple j/double j/unearthed cli player
- Host: GitHub
- URL: https://github.com/unclelukie/jaybird
- Owner: uncleLukie
- License: mit
- Created: 2024-03-10T03:46:19.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-10T04:50:35.000Z (about 2 years ago)
- Last Synced: 2024-05-10T05:35:05.808Z (about 2 years ago)
- Topics: abcradio, cli, discord-rich-presence, dotnet, doublej, music, player, radio, triplej, unearthed, vlc
- Language: C#
- Homepage:
- Size: 232 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# jaybird
a discord rich triple j/double j/unearthed cli player built with .NET 10 (stable).
## screenshots
## requirements
- **Windows:** No additional requirements (self-contained)
- **macOS:** No additional requirements (self-contained)
- **Linux:** Install libVLC: `sudo apt-get install libvlc-dev vlc` (Ubuntu/Debian) or equivalent
- **Discord Desktop Application** (for Rich Presence functionality)
Note: Self-contained builds include .NET 10 runtime, so no separate .NET installation needed.
## why
just wanted an unobtrusive, low memory alternative to listen to these radio stations on my PC that would also update my discord status.
## under the hood
- using [LibVLCSharp](https://www.nuget.org/packages/LibVLCSharp) to listen to the AAC+ streams available at [here](https://help.abc.net.au/hc/en-us/articles/4402927208079-Where-can-I-find-direct-stream-URLs-for-ABC-Radio-stations)
- listening to the respective station api that ABC provides for free https://music.abcradio.net.au/api/v1/plays/triplej/now.json?tz=Australia%2FSydney
- parsing the json response with System.Net.Http.Json
- updating the discord status with [DiscordRichPresence](https://github.com/Lachee/discord-rpc-csharp)
- making the cli pretty with [Spectre.Console](https://www.nuget.org/packages/Spectre.Console)
## installation
### Manual Installation
check [releases](https://github.com/uncleLukie/jaybird/releases)
## cross-platform support
jaybird now supports Windows (x64/x86/ARM64), macOS (Intel/Apple Silicon), and Linux (x64)!
**Linux users:** you need to install LibVLC first:
```bash
# Ubuntu/Debian
sudo apt-get install -y libvlc-dev vlc
# Fedora/RHEL
sudo dnf install -y vlc vlc-devel
# Arch
sudo pacman -S vlc
```
**MacOS users:** the app is unsigned so you have to allow it in the security & privacy settings a few times. Should be fine for subsequent runs.
check [releases](https://github.com/uncleLukie/jaybird/releases) for platform-specific builds.
## wanna help?
I would much appreciate some bug reports or feature requests via [issues](https://github.com/uncleLukie/jaybird/issues)