oe1archive

A tool to download Ö1 radio broadcasts. This repo is a clone of this original repo and there is also a website.

Overview

Browse, search, and download OE1 (Austrian National Radio) broadcasts from the past 30 days with automatic HTML archiving.

Features

• 30-day Interactive Browse - Select any date and download directly
• Fast Search - Search by title and subtitle (≈10 seconds)
• Deep Search - Optional search including descriptions (≈5 minutes)
• Smart Stream Extraction - Automatic loopstream ID retrieval
• Batch Processing - Download multiple shows efficiently
• Organized Storage - Timestamped folders with HTML metadata (format: prefix_yyyyMMdd_hhmm)

Requirements

Python 3.6+ with dependencies:

pip install requests simplejson python-dateutil

Usage

Interactive Mode

./oe1archive -c

Browse all 30 days and download shows directly.

Search Shows by Title and Subtitle

./oe1archive -s "Show Name" -r 30

Fast search across title and subtitle fields. Takes approximately 10 seconds.

Extended Search (including descriptions)

./oe1archive -s "Show Name" -e -r 30

Search all available broadcasts including full description text. Takes approximately 5 minutes. Use this if the regular search doesn't find what you're looking for.

Batch Download

./oe1archive -d "Show Name" -p "prefix"

Download all matching broadcasts with metadata and audio. Use -e flag for extended search: ./oe1archive -d "Show Name" -p "prefix" -e -r 30

Command Examples

# Show usage
./oe1archive -h

# Fast search by title/subtitle
./oe1archive -s "Show Name"

# Search for show with special characters (automatically escaped)
./oe1archive -s "Das gute Leben (2)"

# Search using regex patterns (wildcards still work)
./oe1archive -s "Das.*Leben"

# Search with alternation (OR) patterns
./oe1archive -s "Music|Talk"

# Deep search including descriptions
./oe1archive -s "Some Keyword" -e -r 30

# Batch download all matches (fast search)
./oe1archive -d "Show Name" -p "prefix" -r 30

# Batch download with special characters in title
./oe1archive -d "Das gute Leben (2)" -p "prefix"

# Batch download all matches (deep search)
./oe1archive -d "Some Keyword" -p "prefix" -e -r 30

Search Behavior and Regex Escaping

The search feature uses smart escaping to make searching for titles with special characters intuitive, while preserving regex pattern support.

Automatically Escaped Characters

The following characters are automatically escaped (treated as literals):

• ( ) - parentheses
• { } - curly braces

This means you can search for titles like "Das gute Leben (2)" without needing to manually escape the parentheses.

Supported Regex Patterns

The following regex patterns still work and are NOT escaped:

• .* - match any characters (wildcard)
• .+ - match one or more of any character
• | - alternation (OR operator)
• ^ - start of string
• $ - end of string
• [...] - character classes

Examples

# Literal search - parentheses are automatically escaped
./oe1archive -s "Das gute Leben (2)"

# Regex wildcard - matches "Das gute Leben", "Das schöne Leben", etc.
./oe1archive -s "Das.*Leben"

# Combine both - wildcard with escaped parentheses
./oe1archive -s "Das.*Leben (2)"

# Alternation - matches either "Music" or "Talk"
./oe1archive -s "Music|Talk"

How It Works

The OE1 API provides a rolling weekly window of current broadcasts. Streams remain accessible via loopstream for ~30 days, enabling full month archive access through direct download without search requirements.

Technical Details

• API: https://audioapi.orf.at/oe1/json/2.0/
• Stream Source: https://loopstream01.apa.at/?channel=oe1&shoutcast=0&id=...
• Archive Window: ~30 days (loopstream availability)

Output Structure

prefix_yyyyMMdd_hhmm/
├── prefix_yyyyMMdd_hhmm.html    (Metadata)
└── prefix_yyyyMMdd_hhmm.mp3     (Audio)

Contributors

• Stefan Huber
• Gerhard Mitterlechner