mhahnFr / iSongs-RadioText

Short Java program that displays the currently on the radio broadcasted song. Idea from 2014, remade 2019 and 2023.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Welcome to iSongs-RadioText!

iSongs-RadioText is a small Java application displaying the song currently playing on the radio.

It was extracted from the old iSongs project in 2014 and further developed as a standalone application.

iSongs-RadioText was rewritten in 2019 and 2023.

Screenshots

iSongs

Settings

iSongs settings

Usage

Installation

In order to get started, simply download the latest release here and install it.

Building from source

You can build iSongs-RadioText yourself using Gradle.

Make sure you have installed a Java Development Kit in version 19 or higher. It should include jmods.

Note

On Linux the package rpm-build (Red Hat Linux) or fakeroot (Ubuntu Linux) is needed to create an installation archive.

On macOS the Xcode command line tools are required for creating an installation image.

The following command creates an installation image for your platform:

./gradlew deploy

After running the above command successfully, you can install the generated installation archive.

Using iSongs-RadioText

The songs are recognized by querying the JSON file from the web player of your radio station.

Note

The URI to this file needs to be set in the settings of iSongs-RadioText.

The recognized name and interpreter of the currently played song can be saved into a file.

Note

The path where to store these files can be set in the settings of iSongs-RadioText.

Apple Events on macOS

On macOS, the songs can alternatively or additionally be recognized by sending Apple Events to the Music App. This implies the usage of the web radio feature of the Music App.

Tip

The Apple Events can be enabled in the settings of iSongs-RadioText.

Final notes

This project is licensed under the terms of the GNU GPL version 3 or later.

© Copyright 2014, 2019, 2023 - 2024 mhahnFr

About

Short Java program that displays the currently on the radio broadcasted song. Idea from 2014, remade 2019 and 2023.

License:GNU General Public License v3.0


Languages

Language:Java 98.8%Language:AppleScript 1.2%