Getting Started
What is Statix?
Statix streams music and video from your own servers. Hook it up to an SFTP or FTP server, point it at your files, and you're in business. Local files work too.
Key Features
- Stream from SFTP, FTP, or local storage
- Detailed listening statistics and history
- Smart playlists that update on the fly
- Butterchurn visualizations with hundreds of presets
- 10-band graphic equalizer
- Artist discovery via Last.fm
- Background playback with lock screen controls
The Retro Look
The interface is styled after old CRT monitors. Phosphor glow, scanlines, the works. Every element has that arcade cabinet feel.
CRT Effects
- Scanlines - Horizontal lines like an old TV
- Phosphor glow - That soft bloom around bright elements
- Vignette - Darkened corners like a curved screen
- Bulbous distortion - Slight curvature at the edges
All of this can be adjusted or turned off. Head to the CRT Display panel to tweak the intensity of each effect.
Before You Start
What You Need
- iPhone or iPad running iOS 18.0 or later
- Music or video files somewhere accessible
- For remote streaming: an SFTP or FTP server
Permissions
On first launch, the app asks for local network access. This is for finding servers on your network. You can deny it if you only plan to use remote servers or local files.
Connecting to Your Music
Types of Media Sources
SFTP is the recommended choice for remote access. Your credentials travel encrypted, and the connection is authenticated with your server's SSH setup.
Adding a Remote Server
If the connection works, the server appears on your home screen as a tile. Tap it to browse your files.
Statix tries to auto-detect whether your server speaks SFTP or FTP. If it gets it wrong, you can force a specific protocol in the advanced options.
Adding Local Music
Tap "Add Local Folder" on the home screen. Pick any folder your device has access to, including iCloud Drive locations.
Once added, local sources work exactly like remote ones. Browse, play, scan, favorite.
iOS sandboxing means the app can only see folders you explicitly grant access to. If your music isn't showing up, check that you've selected the right parent folder.
Fixing Connection Problems
Common Issues
- Connection refused - Check the port number. SFTP is usually 22, FTP is 21.
- Authentication failed - Double-check your username and password.
- Timeout - Your server might be behind a firewall. Check that the port is open.
- Host key verification failed - The server's identity changed. If you trust this, clear saved hosts.
Connection Indicator
Browsing & Playing
Browsing Files
Tap a server tile to open the file browser. Folders appear at the top, files below. Tap a folder to go in, swipe from the left edge or tap back to go up.
File Icons
- ▣ Folder
- ♫ Audio file
- ▶ Video file
The browser remembers where you were. Close the app and come back, you'll be in the same folder.
Starting Playback
Tap any audio or video file to play it. The player opens full-screen. For audio, you get visualizations. For video, you get the video.
Every file you play gets recorded in your statistics. That's how smart playlists and the stats dashboard know what you've been listening to.
If you were playing something when the app closed, it'll offer to pick up where you left off next time you open it.
The Now Playing Screen
This is where you spend most of your time during playback. Album art or the visualizer fills the background.
What's On Screen
- Track title, artist, album
- Playback position and duration
- Play/pause, skip forward/back
- Volume slider
- Shuffle and repeat toggles
- Favorite button (heart)
- Queue button
- Equalizer button
Swipe down to minimize and keep browsing while music plays.
Playback Controls
Basic Controls
- Play/Pause - The big button in the middle
- Skip forward - Next track in queue
- Skip back - Previous track, or restart current if past 3 seconds
- Scrubber - Drag to seek within the track
Lock Screen & Control Center
Standard iOS media controls work. Play, pause, skip from the lock screen or Control Center. Album art shows up there too.
Headphone Controls
Wired or Bluetooth headphones with media buttons work as expected. Center click plays/pauses, double-click skips forward, triple-click goes back.
The Queue
The queue is your "up next" list. When you play a file from the browser, everything in that folder gets added to the queue.
Managing the Queue
- Tap the queue icon on the Now Playing screen
- Drag tracks to reorder
- Swipe left on a track to remove it
- Tap any track to jump to it
The queue persists between sessions. Close the app, open it tomorrow, your queue is still there.
Shuffle and Repeat
Shuffle
Tap the shuffle icon to randomize queue order. Tracks play in a random sequence. Tap again to go back to the original order.
Repeat Modes
Cycle through by tapping the repeat icon:
- Off - Stop after the last track
- All - Loop the entire queue
- One - Loop the current track forever
Building Your Library
Scanning Your Collection
Raw file browsing works fine, but the real power comes after you scan. Scanning reads metadata from your files and builds a proper library database.
You need to scan before using: Artist/Album/Genre views, Library Search, and Smart Playlists. These features require the metadata index that scanning creates.
How to Scan
Scan Modes
- Everything - The whole server, top to bottom
- Selected folders only - Just the ones you check
- Everything except selected - Skip folders you don't need
During the Scan
Minimize the scan and keep using the app. A purple banner at the bottom shows progress: track count, artist count, animated dots. Tap the banner to expand back to the full scan view.
Added new music? Reorganized folders? Run another scan. The library updates to match your current files.
The Library View
After scanning, switch from "Files" to "Library" mode. Now you can browse by:
- Artists - Alphabetical list of every artist in your collection
- Albums - All albums, sortable by name or year
- Genres - Everything tagged with Rock, Jazz, Electronic, etc.
Each view shows track counts so you can see how much material you have from each artist or in each genre.
Library Search
There's a search bar at the bottom of the library view. Type anything and results appear instantly.
Result Categories
- Artists (purple icon) - Shows track count
- Albums (blue icon) - Shows artist and year
- Genres (orange icon) - Shows track count
- Tracks (green icon) - Shows artist and album
Each category shows the first five matches. Tap "See all" to expand the full list.
Actions
- Tap a track to play it right away
- Tap an artist to see their albums
- Tap an album to see its track listing
- Tap a genre to browse all matching tracks
Favorites & Discovery
Favorites
Tap the heart icon on the Now Playing screen to favorite a track. Your favorites show up in their own list, accessible from the home screen.
What Happens When You Favorite
Behind the scenes, Statix calls out to Last.fm and fetches similar artists based on the track's artist. These get stored with the favorite for later discovery.
The Favorites List
Your favorites appear in a list, most recent at top. Each row shows:
- Track title and artist
- Album name
- When you favorited it
Tap a favorite to expand it. The expanded view shows more details and any similar artists that were found.
Similar Artists
When you expand a favorite, you'll see a row of similar artists if any were found. These come from Last.fm's database.
What You Can Do
Tap any similar artist name and Statix opens YouTube Music with a search for that artist. Useful for checking out music you don't have yet.
Favorite a track you like → see similar artists → tap one → YouTube Music opens → find new music → add it to your server → scan → repeat.
Artist Info Lookup
Tap the main artist name (not a similar artist) in an expanded favorite to pull up detailed info from MusicBrainz and Last.fm.
What You'll See
- Photo - Artist image from Last.fm
- Biography - Background and history
- Type - Person, group, orchestra, etc.
- Country - Where they're from
- Years active - Formation and dissolution dates
- Tags - Genre labels and styles
- Aliases - Other names they go by
- Related artists - Members, collaborators
- External links - Wikipedia, Spotify, YouTube, official sites
- Discography - Albums, EPs, singles from MusicBrainz
Requires internet. Links open in your browser.
Some VPNs interfere with the MusicBrainz lookup. If it keeps failing, try disabling your VPN temporarily.
Smart Playlists
Creating Smart Playlists
Smart playlists build themselves based on rules you define. They combine your scanned library data with your listening statistics.
Smart playlists need both a scanned library AND some listening history. If you've never played anything, there's nothing for statistics-based rules to work with.
Built-in Playlists
- Heavy Rotation - Tracks you've played the most
- Deep Cuts - Tracks you rarely play
- Recent Discoveries - Stuff you played for the first time lately
Making Your Own
Tap "New Smart Playlist" and set up rules. Each rule has three parts:
- Field - What to check (artist, genre, play count, etc.)
- Operator - How to compare (is, contains, greater than, etc.)
- Value - What to match
Add multiple rules and combine them with AND or OR logic. Set limits if you want. Pick an icon and color to make it yours.
Playing Smart Playlists
Tap a smart playlist to see its matching tracks. The header shows the playlist icon, name, and a summary of the rules.
Playback Options
- Shuffle toggle - Turn on before playing to randomize
- Play All - Starts playback with the current shuffle setting
Tap any track to start from that point instead.
Track List
Each track shows title, artist, and album. Tracks you've played before have a green badge with the play count.
Menu Options
- Edit Playlist - Change the rules
- Refresh - Re-run the rules now
- Delete - Remove it (only for your custom playlists)
Smart playlists refresh when your stats change. Finish a song and it might suddenly qualify for "Heavy Rotation."
Your Listening History
Statistics Dashboard
Every track you play gets recorded. The stats dashboard shows patterns in your listening.
Date Range Filter
- All Time - Everything since you started
- Last 7 Days - Just the past week
- Last 30 Days - The past month
- Last 3 Months - Recent quarter
- Custom Range - Pick exact dates
Dashboard Sections
- Total plays and unique tracks
- Total listening time
- Top tracks, artists, and genres
- Recently played
- New discoveries
Tap any track or artist in these lists to see more detail.
Calendar View
The calendar shows your listening day by day. Days with activity are colored by the dominant genre you listened to.
Genre Colors
- Cyan = Rock
- Magenta = Electronic
- Gold = Jazz
- Green = Classical
- Purple = Hip Hop
Navigate between months with the arrow buttons. Days without any listening stay dark.
Day Details
Tap any colored day for a breakdown:
- Total plays that day
- Total listening time
- Genre breakdown with colored bars
- Top 5 tracks
- Top 5 artists
Track & Artist Details
Tap any track or artist in the statistics views to drill down.
Track Details
- Play count - Total times played
- Average completion - How much you typically listen to
- Longest streak - Most consecutive days played
- First played - When you discovered it
- Last played - Most recent play
- Time of day - Heatmap showing when you typically play it
- Play history - Every play with timestamp
Artist Details
- Total plays across all tracks
- First and last played dates
- All their tracks ranked by play count
Customization
The Equalizer
A 10-band graphic EQ for shaping your sound. Tap the EQ icon on the Now Playing screen.
Frequency Bands
- 31Hz, 63Hz - Sub-bass and bass. Kick drums, bass guitars.
- 125Hz, 250Hz - Low-mids. Body and warmth.
- 500Hz, 1kHz - Midrange. Vocals, most instruments.
- 2kHz, 4kHz - Upper-mids. Presence, clarity.
- 8kHz, 16kHz - Treble. Air, shimmer, cymbals.
Controls
- Preamp - Master volume before EQ. Lower it if you're boosting bands.
- Power toggle - Enable or disable the EQ
- Reset - Flatten all bands to 0dB
- DAS U - A signature preset that creates a smile curve
Each band glows in a different neon color. Settings save automatically.
Sliders give a subtle vibration. Reset and DAS U have a heavier thump.
Music Visualizations
The visualizer uses Butterchurn, a WebGL implementation of the classic Milkdrop presets. Hundreds of trippy patterns that react to your music.
How It Works
Audio feeds into a frequency analyzer. The visualizer reads those frequencies and animates accordingly. Bass hits pulse. Treble sparkles. Mids swirl.
Tap the screen during playback to show/hide the controls. Double-tap to go full screen.
Preset Browser
Tap the preset browser icon to see all available visualizer presets.
Finding Presets
Search by name or creator. Presets are grouped by author, with the most prolific at top. Tap a group to expand, tap a preset to switch immediately.
Auto-Change Settings
- Random Mode - Next preset picked randomly
- Auto-change - Switch presets on a timer
- Interval - 15 seconds, 30 seconds, 1 minute, or 2 minutes
Some presets are GPU-heavy. If your device gets warm or the framerate drops, pick something simpler.
Sleep Timer
Set a timer to stop playback automatically. Good for falling asleep to music.
Options
- 15, 30, 45, or 60 minutes
- End of current track
- Custom duration
When the timer runs out, playback stops and the app goes quiet.
CRT Display
Fine-tune the retro CRT look or turn it off.
Adjustable Effects
- Bulbous Distortion - Screen curvature at edges (0.00–1.00)
- Scan Lines - Horizontal line intensity (0.00–1.00)
- Vignette - Corner darkening (0.00–1.00)
- Text Glow - Phosphor bloom around text (0.00–1.00)
There's a "Reset to Defaults" button if you want to start over.
CRT effects use GPU shaders. They auto-disable when not visible to save power.
More
Supported Formats
Statix uses VLC's playback engine, so format support is wide.
Audio
Video
If VLC plays it on desktop, it'll probably work here too.
A Note on Security
Credential Storage
Server passwords are stored in the iOS Keychain, the same secure enclave that stores your other app passwords and Face ID data.
SFTP vs FTP
SFTP encrypts everything: your password, the file list, the actual data. FTP sends everything in plain text. If you're connecting over the internet, use SFTP.
Statistics
All your listening data stays on-device. Nothing gets sent to any server. The MusicBrainz and Last.fm lookups are the only network calls beyond your own media server.
Glossary
Getting Help
If you run into problems: