Getting Started with FunHoard for iOS

Installation

FunHoard is available as a direct install — check the Download page for the latest information.

First Launch

When you open FunHoard for the first time, you’ll see a welcome screen with two options:

Use without a server (local files only)

Tap Add Folder from Files to select folders from the iOS Files app. FunHoard will scan them and you can immediately browse and play your music, videos, and documents.

Connect to a FunHoard server

Tap Sign In to Server to connect to a running FunHoard server. You’ll need:

  • The server’s address (e.g. http://192.168.1.62:8741)
  • Your username and password

You can do both — use local files AND connect to a server. Local files appear alongside server content in your library.

The Interface

Once set up, you’ll see four tabs:

Library

Browse your media by title, artist, album, genre, or directory. Use the search bar to find anything. Tap a file to play it.

  • Filter by directory using the sidebar
  • Group by artist, album, genre, or directory for organised browsing
  • Search with simple text or advanced queries like artist:Beatles or genre:Jazz

Playlists

View and manage your playlists. Create new playlists, add items from the library or queue, and reorder tracks.

Queue

See what’s playing now, what’s coming up, and what was played before. Drag to reorder, swipe to remove.

Settings

Configure your server connection, local folders, playback options, and more.

Playing Media

  • Audio — plays with a full-screen player showing album art, controls, and an audio visualiser
  • Video — plays in a video player with landscape support and picture-in-picture
  • Documents (PDF, EPUB, TXT, Markdown) — opens in a reader with text-to-speech, bookmarking, and reading position tracking
  • Images — displays with zoom and pan

Text-to-Speech

For documents, tap the play button to have FunHoard read the text aloud. Features include:

  • Device voices — uses your iPhone’s built-in voices (works offline)
  • Server voices — higher quality Piper TTS voices (requires server connection)
  • Position tracking — TTS starts from where you’re reading
  • Headphone controls — play/pause TTS with AirPods or headphone buttons

Offline Access

You can download files for offline playback:

  • From the server — long-press any item and tap “Download”
  • Local files — always available, even without a server

Downloaded content appears in the Queue → Downloads tab.

What’s Next?