61 lines
3.4 KiB
Markdown
61 lines
3.4 KiB
Markdown
# RadioDJViewer
|
|
|
|
RadioDJViewer is a Windows Forms application for displaying song information and album art from a RadioDJ REST API. It is designed for use with RadioDJ automation software and provides a simple interface for viewing and exporting currently playing track details.
|
|
|
|
## Features
|
|
- Connects to RadioDJ REST API to acquire song info
|
|
- Displays title, artist, and album (with scrolling marquee for long text)
|
|
- Shows album art or a fallback image if none is available
|
|
- Exports title, artist, album, and album art to output folder
|
|
- Supports multiple profiles for different RadioDJ instances
|
|
- Auto-regenerates missing `profiles.json` and fallback image
|
|
|
|
## Requirements
|
|
- Windows 7 or later
|
|
- .NET Framework 4.7.2
|
|
- RadioDJ REST API running and accessible
|
|
|
|
## Installation
|
|
1. Download the release ZIP and extract all files to a folder.
|
|
2. Ensure the following files are present:
|
|
- `RadioDJViewer.exe`
|
|
- `Newtonsoft.Json.dll`
|
|
- `RadioDJViewer.exe.config`
|
|
- (Optional) `default.jpg` and `profiles.json` (will be auto-generated if missing)
|
|
3. Run `RadioDJViewer.exe`.
|
|
|
|
## Usage
|
|
1. Configure a profile with the REST API URL, output folder, and image settings.
|
|
2. Click Connect to start polling the API and display song info.
|
|
3. Output files will be saved in the selected output folder.
|
|
4. If album art is missing, a fallback image will be used.
|
|
|
|
## Some info for you
|
|
1. URL format follows the format from RadioDJ (http://{ip}:{port}/np?auth={password})
|
|
2. The Variables that you see in the URL format like "{ip},{port} and {password}" They need to be present in format box which you would have typed out, If not the program cannot access the REST API
|
|
|
|
## License
|
|
This project is licensed under the MIT License.
|
|
|
|
## Repository
|
|
[https://git.smartcraft.me/minster586/RadioDJViewer](https://git.smartcraft.me/minster586/RadioDJViewer)
|
|
|
|
## My inspiration
|
|
I was inspired to use this make this program by a few people as I use Radio DJ for pretty much everything music relatedwise.
|
|
When I started this it originally was just a command line console based program written in Java which is still available and works on pretty much any OS you can think of
|
|
This started off as a thing where I wanted my actual music playing program for streams playing video games to show what was playing
|
|
A quick google search led to a bunch of things that I liked but were web based and I was trying to stick away from web based programs
|
|
And I know that particular person that I'm about to mention is probably going to look at this and get a kick out of it
|
|
It got me thinking that is there a way that I can get the information and parse that information and this program was born
|
|
|
|
[https://www.youtube.com/@RodericksRadioDJTutorials] Yes I put your Youtube channel
|
|
|
|
All things aside it works the way that I like there are a few more changes that I want to do to it
|
|
For example debugging and what not but it should work on pretty much any system that has .NET framework 4.7.2 Obviously it says that in the requirements
|
|
I will say the biggest thing that helped me was copilot I know it seems a little strange but as I am just learning how to do this I figured why not give it a shot
|
|
|
|
With that being said if you want to see it live in action you can find my links page here Pop into my streams ask me about it
|
|
[https://links.smartcraft.me/@minster586]
|
|
|
|
---
|
|
For questions or issues, please open an issue on the repository or contact the maintainer. |