Miner Support

Contact

Email: hswillg@gmail.com

App Overview

Miner: Photo & Media Player puts your personal media library beautifully on the big screen. It is the official Apple TV (and iOS) companion for Miner, the self-hosted media server that runs on your own computer or NAS. Connect once over your home network and instantly browse your entire photo and video collection — organized by day, by album, or by folder — with no cloud, no subscription, and no uploads. Your memories stay on your hardware, on your network, under your control.

Key Features

• Home — A time-machine view of every memory, grouped by date with smart pagination so even libraries with hundreds of thousands of items scroll smoothly.
• Favorites — Star the photos and videos you love. Filter by All, Photos, or Videos for quick access.
• Albums — Curated collections with beautiful stacked-card previews. Build albums on any Miner client and they show up everywhere instantly.
• Folders — Browse your library exactly as it lives on disk. Great for power users who organize by year, trip, project, or shoot.
• Full-Screen Viewer — Lean back and let photos fill the screen, or hit play on any video with AVKit-powered smooth playback, scrubbing, and resume-where-you-left-off.
• Multi-Library Support — Run separate libraries for Family, Travel, Work, or anything else. Switch between them right from the Home tab.

Requirements

• Apple TV: tvOS 17 or later (native SwiftUI, optimized for 1080p and 4K).
• iPhone & iPad: iOS 17 or later.
• A running Miner server on your local network. Miner is a free, open, single-binary media server you can install on macOS, Linux, or a NAS in minutes.
• Your device and the Miner server must be on the same home network (or connected to it) for streaming.

Getting Started

1. Install and run the Miner server on your computer or NAS. Make a note of its IP address and port.
2. Open Miner on your Apple TV or iOS device.
3. Enter your server's IP address and port, then sign in with the account set on your Miner server.
4. Allow Local Network access when prompted. Your connection is saved for next time.

Troubleshooting

• Can't find or connect to my server: Confirm your Apple TV / iPhone / iPad and the Miner server are on the same Wi-Fi or wired network. Double-check the IP address and port you entered. If the server machine has a firewall, make sure the Miner port is open for local traffic.
• "Local Network" permission prompt: Miner needs Local Network access to reach your server. If you declined it, open iOS Settings › Privacy & Security › Local Network and enable it for Miner (on Apple TV, check Settings › General › Privacy › Local Network).
• Login fails: The only login is the one on your Miner server. Use the username and password configured there. If you forgot it, reset the credentials on the server side.
• Thumbnails or videos won't load: The Miner server uses FFmpeg for scanning, thumbnailing, and transcoding. Make sure FFmpeg is installed on the server and that a scan has completed. Large libraries take time to index on first run.
• Library is empty: Verify that the server's library folders contain supported photos and videos, and that a scan has finished. You can trigger a rescan from the server.
• Video playback stutters: Streaming quality depends on your server's CPU (for transcoding) and your local network speed. For high-bitrate files, a wired network connection is recommended.
• Albums aren't showing: Albums are created on a Miner client and synced through your server. Make sure your server is running and reachable, then pull to refresh or restart the app.
• Siri Remote focus feels off: Press Menu to go back one level. If a card seems stuck, move focus away and back, or relaunch the app.

Privacy & Data

Nothing leaves your home network. Miner talks directly to your server — no analytics, no third parties, and no accounts to create with us. Your server connection details are stored only on your device. For full details, see the Privacy Policy and Terms of Use.