Adding Media on iOS
FunHoard can play media from two sources: local files on your device and server files streamed from a FunHoard server. You can use either or both.
Local Files (from the Files App)
Play music, videos, documents, and audiobooks stored on your iPhone or in iCloud Drive — no server needed.
Adding a Local Folder
- Open FunHoard → Settings
- Under Local Media Folders, tap Add Folder from Files
- The iOS file picker opens — navigate to the folder you want
- Tap Open
FunHoard scans the folder and all subfolders for media files. The scan count appears next to the folder name.
What can I add?
Any folder visible in the iOS Files app:
- On My iPhone — files stored locally on your device
- iCloud Drive — files in your iCloud (downloaded on demand)
- Third-party storage — Dropbox, Google Drive, OneDrive, etc. (if their app is installed)
- Connected servers — SMB/NFS shares connected via Files
Supported Formats
| Type | Extensions |
|---|---|
| Audio | mp3, m4a, flac, wav, ogg, aac, aiff, opus |
| Video | mp4, mov, m4v |
| Documents | pdf, epub, txt, md, html |
| Images | jpg, png, gif, webp |
Note: Some formats (like MKV or FLAC video) may require transcoding from a connected server. Local playback works best with iOS-native formats.
Managing Local Folders
- Toggle — enable/disable a folder without removing it (tap the toggle switch)
- Scan — swipe left on a folder and tap “Scan” to refresh
- Remove — swipe left and tap “Remove” (doesn’t delete the files, just removes from FunHoard)
- Scan All — tap “Scan All Folders” to refresh everything
Files stay in their original location — FunHoard never copies, moves, or deletes your files.
Server Media (Streaming)
When connected to a FunHoard server, you have access to the server’s entire media library.
Browsing Server Content
- All server media appears in the Library tab alongside local files
- Use the directory filter to browse by folder
- Search works across both local and server content simultaneously
Downloading for Offline
To save server files for offline playback:
- Long-press any track or document in the library
- Tap Download
- The file downloads in the background
Downloaded files appear in Queue → Downloads and play without a server connection.
You can also download entire playlists:
- Go to Playlists → select a playlist
- Tap the download icon in the toolbar
Download Management
In Settings, you can:
- Set a maximum download size to limit storage usage
- View total download size
- Remove individual downloads or clear all
Mixing Local and Server Content
When you have both local folders and a server connection:
- The Library shows everything together — local and server files
- Search finds matches in both sources
- The source badge on the Now Playing screen shows where each file is from:
- 🟢 Local file — from the Files app
- 🟢 Downloaded — saved from server
- 📡 Streaming — playing from server in real time
Creating Playlists with Mixed Content
Playlists can contain both local and server files. When playing a mixed playlist:
- Local files play immediately
- Server files stream (or play from download cache if previously downloaded)
What’s Next?
- Set up remote access to stream when away from home
- Server setup if you don’t have a server yet