System Settings
Update notifications, backup/restore, local caching, and API configuration.
Update Notifications
Teamarr can check for new versions and notify you when updates are available.
Current Version
Displays your current version and the latest available version. For dev builds, shows commit hashes; for stable builds, shows version numbers.
The release date of the latest version is shown in your configured timezone.
Settings
| Setting | Description |
|---|---|
| Enable Automatic Update Checks | Toggle update checking on/off |
| Notify about stable releases | Get notified about new stable versions |
| Notify about dev builds | Get notified about new dev commits (if running dev) |
Check Now
Manually trigger an update check. Results are cached for 1 hour.
Backup & Restore
Download Backup
Download a complete backup of your Teamarr database, including:
- All teams and their configurations
- Templates and presets
- Event groups
- Settings
Restore Backup
Upload a .db backup file to restore. A backup of your current data is automatically created before restoring.
Restoring a backup replaces ALL current data. The application needs to be restarted after restore.
Local Caching
Teamarr caches team and league data from ESPN and TheSportsDB to improve performance and enable offline matching.
Cache Status
View the current cache state:
- Leagues - Number of leagues cached
- Teams - Number of teams cached
- Last Refresh Duration - How long the last refresh took
- Last Refresh - When the cache was last updated
A Stale badge appears if the cache needs refreshing.
Refresh Cache
Manually refresh the cache to pull the latest team and league data. This fetches data from ESPN and TheSportsDB APIs.
Cache refresh runs automatically on first startup. Manual refresh is useful after adding new leagues or when team rosters change significantly.
TheSportsDB API Key
Optional premium API key for TheSportsDB. The card header shows your current tier (Free Tier / Premium).
| Tier | Rate Limit | Events per Query | Cost |
|---|---|---|---|
| Free | 30 req/min | 5 per day per league | Free |
| Premium | 100 req/min | Full coverage | ~$9/mo |
Some TSDB leagues (CFL, Unrivaled, boxing, Norwegian hockey) work fine on the free tier. Premium leagues — AFL, NRL, Super Rugby, cricket (IPL, BBL, SA20), and Svenska Cupen — need a premium key for full event coverage. The league picker shows a crown icon on premium leagues.
Use the Validate button to test your key before saving. Get a key at thesportsdb.com/pricing.
See TSDB Provider for technical details.
XMLTV Generator Metadata
Customize the generator information included in the XMLTV output file.
| Field | Default |
|---|---|
| Generator Name | Teamarr |
| Generator URL | https://github.com/Pharaoh-Labs/teamarr |
These values appear in the XMLTV file header and are used by some media servers to identify the EPG source.