RFM-Radio Real FM radio for Android. @codeKK Android开源站

RFM-Radio

Project Url: vladislav805/RFM-Radio

Introduction: Real FM radio for Android.

More: Author ReportBugs OfficialWebsite

Tags:

Off-

Real FM hardware radio app for Android Qualcomm Snapdragon based devices.

Requirements

Android 6.0+ (SDK 23+).
Root access is required, especially on AOSP-based ROMs.

Features

Live FM playback using supported hardware backend.
RDS metadata: PS, RT, PTY.
Recording to .wav and .mp3, with a matching .srt file containing frequency, PI, PS and RT.
Favorites (presets) with custom names.
Multiple favorite lists.
Favorite list manager screen with import/export.

Favorites UX

Main screen: tune quickly, reorder presets, switch active favorite list.
Favorite Lists screen: manage lists (create, rename, remove, import, export).

Settings highlights

Tuner

Enable RDS

RDS is a radio data system. When this option is enabled, the application will display data transmitted from the radio station, such as the Program Service and Radio Text.

Antenna

Select an antenna. In most cases: 0 - default, headphones; 1 - internal (bad quality).

Application

Autostart

If enabled, audio from the radio will be immediately turned on after starting the application.

Notifications

Show PS in title

If the option is enabled, then with the "Enable RDS" option enabled, the Program Service and Radio Text will be displayed in the notification header.

Screenshots

Main screen Searching Settings screen

Building

Clone the repository with submodules:

git clone --recursive https://github.com/vladislav805/RFM-Radio.git

For an existing checkout:

git submodule update --init --recursive

./gradlew :app:assembleDebug

Use make build-debug for a debug APK or make build-release for a release APK. Release signing uses the ANDROID_RELEASE_* environment variables described below; without signing credentials, the release APK is unsigned.

Gradle builds the app native MP3 encoder and FM backend assets automatically. For native/FM backend-related work you also need Android NDK headers and device-specific tooling.

The MP3 encoder uses LAME 4.0 from the enzo1982/lame SVN mirror, pinned as a Git submodule to commit 5a2d347159f9e6e441ee436407949e122ae802dc (tag RELEASE__4_0). The encoder sources and headers match the official 4.0 release archive. CMake builds the checked-out sources without downloading dependencies.

Run Java unit tests with make test-java and native host tests with make test-native.

RDS recording subtitles

The Save RDS as subtitles option in recording settings is disabled by default. When enabled, each MP3/WAV recording is accompanied by a UTF-8 SRT file with the same basename in the same folder. Changes apply to new recordings; disabling the option leaves existing SRT files untouched. Each cue shows the frequency and four-digit hexadecimal PI, followed by PS and RT. An unknown PI is written as 0000; unavailable PS/RT are shown as —. ECC is not recorded.

Subtitle times follow captured PCM, including the available pre-roll history. They indicate when RDS updates were received, which can differ from the timing of the broadcast audio. Deleting a recording through its notification also removes its SRT file. If saving subtitles fails, the audio is preserved and the app shows a warning. Automatic SRT loading for audio depends on the player.

Android 10 requires storage permission when SRT saving is enabled. Android 9 and older require it for audio as well. Android 11+ publishes both files through MediaStore.

GitHub Actions

Pull requests and pushes to master run native host tests, build a debug APK, and run Android unit tests. APKs and unit test reports are available as workflow artifacts.

Pushing a vMAJOR.MINOR.PATCH tag or manually running Android Build with a version builds a release APK and creates a draft GitHub release containing the APK. The requested version must match the APK version from app/build.gradle; the workflow does not change the app version.

Release signing uses the repository secrets ANDROID_RELEASE_KEYSTORE_BASE64, ANDROID_RELEASE_STORE_PASSWORD, ANDROID_RELEASE_KEY_ALIAS, and ANDROID_RELEASE_KEY_PASSWORD. Without signing credentials, the release APK is unsigned. The keystore is removed after the build.

Dependabot checks GitHub Actions updates monthly.