A Lidarr companion app
Find a file
2026-05-11 14:39:08 -07:00
screenshots Ignore .DS_Store files and remove tracked ones 2026-05-11 14:07:50 -07:00
Seekarr Fix artist artwork auth URL 2026-05-11 14:39:08 -07:00
Seekarr.xcodeproj Fix artist artwork auth URL 2026-05-11 14:39:08 -07:00
SeekarrTests Initial commit 2026-05-11 13:41:18 -07:00
.gitignore Ignore .DS_Store files and remove tracked ones 2026-05-11 14:07:50 -07:00
project.yml Initial commit 2026-05-11 13:41:18 -07:00
README.md Add screenshots to README 2026-05-11 14:07:29 -07:00

Seekarr

A native iOS and iPadOS app for managing Lidarr — your music collection manager.

Seekarr brings the full Lidarr experience to your iPhone and iPad with a clean, native interface following Apple design principles.


Features

Artists

  • Browse all artists in your Lidarr library
  • View all albums per artist
  • Monitor, refresh, or search individual albums
  • Select album releases (US, UK, Japan, etc.)
  • View track listings per album
  • Search albums (automatic and interactive)
  • Add and manage tags
  • Add new artists with full control over monitoring, album selection, and tags

Activity

  • View active downloads in real time
  • See indexer, download client, and Custom Format score per item

Calendar

  • Visual calendar of upcoming and recent album releases
  • Scroll to any date to see what's releasing and when

Settings

  • App Settings: Configure your Lidarr server URL (local or remote) and API key, with support for custom headers. Set your default landing page.
  • Media Management: Adjust root folder settings including quality profile, metadata profile, monitoring behavior, and tags.
  • Tags: Create and manage tags; configure Lidarr's auto-tag feature.

Requirements

  • iOS 16+ / iPadOS 16+
  • A running Lidarr instance
  • Lidarr API key

Installation

  1. Clone the repo:

    git clone https://forgejo.odinactual.com/aaron/seekarr.git
    cd seekarr
    
  2. Open Seekarr.xcodeproj in Xcode

  3. Set your development team under Signing & Capabilities

  4. Build and run on your device or simulator


Configuration

On first launch, go to Settings → App Settings and enter:

  • Your Lidarr server URL (e.g. http://192.168.1.100:8686 or https://lidarr.example.com)
  • Your Lidarr API key

Design Philosophy

Seekarr is built to feel at home on Apple platforms — following Human Interface Guidelines, supporting Dark and Light Mode, and embracing Apple's glass design language. If it doesn't feel native, it's not done yet.


Screenshots

Artists Activity Calendar
Artists Activity Calendar
Settings Appearance Media Management Wanted
Settings Appearance Media Management Wanted

License

MIT