rajio-sen 1.1.0

ラジオ船 (Rajio-Sen): A minimalist vaporwave-inspired pirate radio scanner for the terminal.

ＲＡＪＩＯ - ＳＥＮ ( ラジオ船 )

ＵＮＤＥＲＧＲＯＵＮＤ ＦＲＥＱＵＥＮＣＩＥＳ // ＰＩＲＡＴＥ ＲＡＤＩＯ ＳＣＡＮＮＥＲ

ＯＶＥＲＶＩＥＷ (概要)

Rajio-Sen is a minimalist, vaporwave-themed terminal radio scanner. It allows you to tune into thousands of radio stations globally directly from your command line.

This project is a heavily modified hard-fork of the original radio-active application. It has been completely rebuilt to bypass abandoned dependencies (such as pyradios) in favor of a modern, direct-REST API communication with the Radio-Browser database. The user interface has been redesigned using rich to provide a sleek terminal display with bilingual Japanese/English typography and a custom Luminous Nebula palette.

ＦＥＡＴＵＲＥＳ (特徴)

• Direct API Integration: Connects directly to the Radio-Browser network for live, real-time station data.
• Vaporwave TUI: Stripped-down minimalist terminal interface featuring rich box styling and full-width characters.
• Update Notifications: Checks for software updates against the official GitHub releases API.
• Supports more than 40K stations globally.
• Record audio from live radio streams on demand via FFmpeg.
• Save and manage favorite stations effortlessly.
• Discover stations by tag, country, or language.
• VLC, MPV, and FFplay player support.
• Integrated Sleep Timer functionality.

ＩＮＳＴＡＬＬ (インストール)

ＡＵＲ

For users on Arch-based systems, it is recommended to install via the AUR:

# Using yay
yay -S rajio-sen

# Using paru
paru -S rajio-sen

Manual Installation

# Clone the repository
git clone https://github.com/jullespio/rajio-sen.git
cd rajio-sen

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate

# Install the application and dependencies
pip install .

Note: You must have FFmpeg installed on your system to process and record audio streams.

ＲＵＮ (起動)

Once installed, use the rajio command to initialize the interface:

# Search for a specific genre or name
rajio --search "city pop"

# Play directly from your favorites list
rajio --play "Night City"

ＯＰＴＩＯＮＳ (設定)

Options	Description	Default	Values
(No Option)	Select a station from menu to play	False
--search, -S	Search station by name	None
--play, -P	Play from favorites or direct URL	None
--country, -C	Filter stations by country code	False
--tag	Search stations by tags/genre	False
--record , -R	Record current station to file	False
--limit	Limit number of search results	100
--volume , -V	Set playback volume	80	[0-100]
--favorite, -F	Add current station to favorites	False

ＲＵＮＴＩＭＥ ＣＯＭＭＡＮＤＳ (操作)

Input commands during playback to perform the following actions:

p             : Play/Pause
t / track     : Display current stream metadata
i / info      : Information about the station
r / record    : Toggle recording mode
l / list      : Display favorites list
f / fav       : Add station to favorites list
e / edit      : Edit favorites list
s / search    : Search by tag/genre
n / next      : Play next result in current list
timer / sleep : Set sleep timer duration (minutes)
q / quit      : Close the application

ＣＯＮＦＩＧＵＲＡＴＩＯＮ (システム構成)

Configuration and data files are located in the user home directory:

• Config: ~/rajio_sen/config.ini
• Favorites: ~/rajio_sen/alias_map
• Recordings: ~/rajio_sen/recordings

ＡＣＫＮＯＷＬＥＤＧＥＭＥＮＴＳ (謝辞)

Rajio-Sen is maintained by ジュレス (juresu). Originally forked from radio-active by Dipankar Pal. Refactored for modern performance and aesthetic standards.

ＲＡＤＩＯ ＷＡＶＥＳ ＯＦ ＴＨＥ ＦＵＴＵＲＥ