https://github.com/iomz/radikron
📼 Don't let your favorite shows on radiko.jp missed anymore. 📻
https://github.com/iomz/radikron
aac docker docker-compose gocron golang golang-application id3v2 japan mp3 radiko radio recorder
Last synced: 2 months ago
JSON representation
📼 Don't let your favorite shows on radiko.jp missed anymore. 📻
- Host: GitHub
- URL: https://github.com/iomz/radikron
- Owner: iomz
- License: gpl-3.0
- Created: 2023-05-21T12:24:51.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-06-05T11:42:47.000Z (about 1 year ago)
- Last Synced: 2025-06-20T02:36:00.322Z (about 1 year ago)
- Topics: aac, docker, docker-compose, gocron, golang, golang-application, id3v2, japan, mp3, radiko, radio, recorder
- Language: Go
- Homepage:
- Size: 194 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/iomz/radikron/actions?query=workflow%3Abuild)
[](https://github.com/iomz/radikron/actions/workflows/docker.yml)
[](https://github.com/iomz/radikron/pkgs/container/radikron)
[](https://godoc.org/github.com/iomz/radikron)
[](https://codecov.io/gh/iomz/radikron)
[](https://goreportcard.com/report/github.com/iomz/radikron)
[](https://www.gnu.org/licenses/gpl-3.0)
Sometimes we miss our favorite shows on [radiko](https://radiko.jp/) and they get vanished from http://radiko.jp/#!/timeshift – let's just keep them automatically saved locally, from AoE.
**Disclaimer**:
- Never use this program for commercial purposes.
---
- [Requirements](#requirements)
- [Installation](#installation)
- [Configuration](#configuration)
- [Usage](#usage)
- [Try with Docker](#try-with-docker)
- [Build the image yourself](#build-the-image-yourself)
- [Credit](#credit)
## Requirements
radikron requires [FFmpeg](https://ffmpeg.org/download.html) to combine m3u8 chunks to a single aac file (or convert to mp3).
Make sure `ffmpeg` exists in your `$PATH`.
The [docker image](#try-with-docker) already contains all the requirements including ffmpeg.
## Installation
```bash
go install github.com/iomz/radikron/cmd/radikron@latest
```
## Configuration
Create a configuration file (`config.yml`) to define rules for recording:
```yaml
area-id: JP13 # if unset, default to "your" region
extra-stations:
- ALPHA-STATION # include stations not in your region
ignore-stations:
- JOAK # ignore stations from search
minimum-output-size: 2 # do not save an audio below this size (in MB), default is 1 (MB)
rules:
airship: # name your rule as you like
station-id: FMT # (optional) the staion_id, if not available by default, automatically add this station to the watch list
title: "GOODYEAR MUSIC AIRSHIP～シティポップ レイディオ～" # this can be a partial match
citypop:
keyword: "シティポップ" # search by keyword (also a partial match)
window: 48h # only within the past window from the current time
hiccorohee:
pfm: "ヒコロヒー" # search by pfm
trad:
dow: # filter by day of the week (e.g, Mon, tue, WED)
- wed
- thu
station-id: FMT
title: "THE TRAD"
```
In addition, set `${RADICRON_HOME}` to set the download directory.
## Usage
```bash
mkdir -p ./radiko/{downloads,tmp} && RADICRON_HOME=./radiko radikron -c config.yml
```
### Try with Docker
By default, it mounts `./config.yml` and `./radiko` to the container.
```console
docker compose up
```
## Build the image yourself
In case the [image](https://github.com/iomz/radikron/pkgs/container/radikron) is not available for your platform:
```console
docker compose build
```
## Credit
This project is heavily based on [yyoshiki41/go-radiko](https://github.com/yyoshiki41/go-radiko) and [yyoshiki41/radigo](https://github.com/yyoshiki41/radigo), and therefore follows the [GPLv3 License](https://github.com/yyoshiki41/radigo/blob/main/LICENSE).