External Sources
Import audio content from external servers automatically.
Source Types
HTTP
Download files directly from a URL.
| Field | Description |
|---|---|
| URL | Direct link to the audio file |
FTP
Connect to an FTP server and import files from a directory.
| Field | Description |
|---|---|
| Host | FTP server address |
| Port | Connection port (default: 21) |
| Username | FTP account username |
| Password | FTP account password |
| Path | Directory path on the server |
RSS
Subscribe to podcast feeds and import new episodes.
| Field | Description |
|---|---|
| URL | RSS feed address |
Media Type
All source types include a Media Type dropdown. Imported files are assigned the selected media type automatically.
FTP Path Variables
Use variables in the FTP path to create dynamic paths based on the current date and time.
| Variable | Description | Example |
|---|---|---|
{YEAR} | Four-digit year | 2026 |
{MONTH} | Two-digit month | 01 |
{DAY} | Two-digit day | 26 |
{HOUR} | Two-digit hour (24h) | 14 |
{MINUTE} | Two-digit minute | 30 |
{SECOND} | Two-digit second | 45 |
{UNIX} | Unix timestamp | 1769522400 |
{UNIX_UTC} | Unix timestamp (UTC) | 1769522400 |
{ISO} | ISO 8601 timestamp | 2026-01-26T14:30:45 |
{YEAR_UTC} | Four-digit year (UTC) | 2026 |
{MONTH_UTC} | Two-digit month (UTC) | 01 |
{DAY_UTC} | Two-digit day (UTC) | 26 |
{HOUR_UTC} | Two-digit hour (UTC) | 13 |
{MINUTE_UTC} | Two-digit minute (UTC) | 30 |
{SECOND_UTC} | Two-digit second (UTC) | 45 |
{ISO_UTC} | ISO 8601 timestamp (UTC) | 2026-01-26T13:30:45Z |
Example Paths
/recordings/{YEAR}/{MONTH}/{DAY}/
→ /recordings/2026/01/26/
/shows/morning-{YEAR}{MONTH}{DAY}.mp3
→ /shows/morning-20260126.mp3Adding an External Source
- Open External Sources in the station sidebar
- Click Add Source
- Select the source type (HTTP, FTP, or RSS)
- Enter the connection details
- Select a media type for imported files
- Click Save
Connection Testing
Each external source can be tested before activation. The connection test verifies that the source is reachable and returns valid audio data.
- Open the external source configuration.
- Click Test Connection.
- Review the test results.
The test performs the following checks depending on the source type:
| Source Type | Checks Performed |
|---|---|
| HTTP | URL reachability, file download, audio format validation, file size |
| FTP | Server connection, authentication, path validation, file listing |
| RSS | Feed parsing, enclosure detection, audio file download |
Failed tests display an error message with details about the failure point. Fix the configuration and re-test before saving.
Status Monitoring
External sources display their current status in the source list. The status indicates whether the last download attempt was successful.
| Status | Meaning |
|---|---|
| Completed | Last download successful, audio file ready |
| Downloading | Download currently in progress |
| Processing | Downloaded file is being processed |
| Pending | Download scheduled but not yet started |
| Failed | Last download attempt failed |
| Validation Failed | Downloaded file did not pass audio validation |
Click on a source to view the detailed connection log. The log shows timestamps, download durations, and error messages for each attempt.