LOADING MANUAL...

STATIX

User Manual v1.0

TestFlight Beta
Join Beta
◆ Free To Play ◆
iOS 18.0+
Part I

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.

Statix home screen
Home Screen
▶▶▶
Stream
█▌▐░
Statistics
◆◇◆
Visualizer
♪♫♪
Equalizer

Key Features

◆═══════════════════◆═══════════════════◆

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

All of this can be adjusted or turned off. Head to the CRT Display panel to tweak the intensity of each effect.

CRT effects demo
CRT Effects
◆═══════════════════◆═══════════════════◆

Before You Start

What You Need

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.

Part II

Connecting to Your Music

Types of Media Sources

SFTP - SSH File Transfer Protocol. Encrypted, secure.
FTP - File Transfer Protocol. Unencrypted, legacy.
Local - Files on your device or iCloud Drive.

SFTP is the recommended choice for remote access. Your credentials travel encrypted, and the connection is authenticated with your server's SSH setup.

Media source selection
Source Types
◆═══════════════════◆═══════════════════◆

Adding a Remote Server

Tap the + button on the main screen
Enter your server's hostname or IP address
Enter port (22 for SFTP, 21 for FTP)
Enter your username and password
Tap Connect

If the connection works, the server appears on your home screen as a tile. Tap it to browse your files.

Server connection screen
Add Server
◆ Protocol Detection

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.

⚠ File Access

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 Indicator

Connected and working
Connecting or reconnecting
Connection lost or failed
Part III

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

The browser remembers where you were. Close the app and come back, you'll be in the same folder.

File browser
File Browser
◆═══════════════════◆═══════════════════◆

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.

◆ Resume Playback

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.

Now Playing screen
Now Playing

What's On Screen

Swipe down to minimize and keep browsing while music plays.

◆═══════════════════◆═══════════════════◆
◄►

Playback Controls

Basic Controls

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

The queue persists between sessions. Close the app, open it tomorrow, your queue is still there.

Queue management
The Queue
◆═══════════════════◆═══════════════════◆

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:

Shuffle and repeat controls
Shuffle & Repeat
Part IV

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.

⚠ Why This Matters

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

Connect to your server
Tap the scan option in the menu
Pick what to scan

Scan Modes

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.

◆ Rescan When Needed

Added new music? Reorganized folders? Run another scan. The library updates to match your current files.

Scanning progress
Scan Progress
◆═══════════════════◆═══════════════════◆

The Library View

After scanning, switch from "Files" to "Library" mode. Now you can browse by:

Library view
Library View

Each view shows track counts so you can see how much material you have from each artist or in each genre.

◆═══════════════════◆═══════════════════◆

Artists, Albums & Genres

The library has a natural drill-down flow. Start broad, tap to go deeper.

Artist View

Tap an artist to see all their albums. The header shows album and track totals. Hit "Play All" to hear their entire catalog in one go. There's a search bar for filtering.

Album View

Tap an album to see its tracks in order. You get title, artist, year, and track count. Play All starts from track one. Shuffle mixes it up. Tap any track to start from that point.

Genre View

Genres pull together all tracks with that tag, regardless of artist or album. The icon changes based on genre type—guitars for rock, waveforms for electronic. Same controls: Play All, Shuffle, search.

Artist album view
Artist & Album View
◆═══════════════════◆═══════════════════◆
Part V

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:

Tap a favorite to expand it. The expanded view shows more details and any similar artists that were found.

Favorites list
Favorites
◆═══════════════════◆═══════════════════◆

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.

◆ Discovery Flow

Favorite a track you like → see similar artists → tap one → YouTube Music opens → find new music → add it to your server → scan → repeat.

Similar artists list
Similar Artists
◆═══════════════════◆═══════════════════◆

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.

Artist info lookup
Artist Info

What You'll See

Requires internet. Links open in your browser.

⚠ VPN Issues

Some VPNs interfere with the MusicBrainz lookup. If it keeps failing, try disabling your VPN temporarily.

Part VI

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 playlist editor
Smart Playlist Editor
⚠ Requirements

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

Making Your Own

Tap "New Smart Playlist" and set up rules. Each rule has three parts:

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

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

◆ Auto-Update

Smart playlists refresh when your stats change. Finish a song and it might suddenly qualify for "Heavy Rotation."

Smart playlist detail view
Smart Playlist Detail
Part VII

Your Listening History

Statistics Dashboard

Every track you play gets recorded. The stats dashboard shows patterns in your listening.

Statistics dashboard
Statistics Dashboard
###
Play Count
◄██►
Total Time
▲▲▲
Completion %
■□■
Date Tracking

Date Range Filter

Dashboard Sections

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.

Calendar view
Calendar View

Genre Colors

Navigate between months with the arrow buttons. Days without any listening stay dark.

Day Details

Tap any colored day for a breakdown:

◆═══════════════════◆═══════════════════◆

Track & Artist Details

Tap any track or artist in the statistics views to drill down.

Track Details

Artist Details

Track details view
Track Details
Part VIII

Customization

The Equalizer

A 10-band graphic EQ for shaping your sound. Tap the EQ icon on the Now Playing screen.

Equalizer
10-Band Equalizer

Frequency Bands

Controls

Each band glows in a different neon color. Settings save automatically.

◆ Haptic Feedback

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.

Music visualizer
Butterchurn Visualizer

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

◆ Performance

Some presets are GPU-heavy. If your device gets warm or the framerate drops, pick something simpler.

Preset browser
Preset Browser
◆═══════════════════◆═══════════════════◆

Sleep Timer

Set a timer to stop playback automatically. Good for falling asleep to music.

Options

When the timer runs out, playback stops and the app goes quiet.

Sleep timer
Sleep Timer
◆═══════════════════◆═══════════════════◆

CRT Display

Fine-tune the retro CRT look or turn it off.

Adjustable Effects

There's a "Reset to Defaults" button if you want to start over.

◆ Performance

CRT effects use GPU shaders. They auto-disable when not visible to save power.

CRT settings panel
CRT Settings
Part IX

More

Supported Formats

Statix uses VLC's playback engine, so format support is wide.

Audio

MP3 AAC FLAC ALAC WAV OGG OPUS WMA AIFF APE

Video

MP4 MKV AVI MOV WMV WEBM FLV

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

SFTP
SSH File Transfer Protocol. Secure, encrypted file access over SSH.
FTP
File Transfer Protocol. Old-school file access. Unencrypted.
VLC
VideoLAN Client. The open-source media engine that powers playback.
Butterchurn
A WebGL music visualizer based on Milkdrop presets.
Queue
The list of tracks lined up to play next.
Smart Playlist
A playlist that updates itself based on rules you set.
MusicBrainz
An open music encyclopedia. Used for artist info lookups.
Last.fm
A music data service. Provides artist photos, bios, and similar artists.
Preamp
Volume control before the equalizer. Prevents distortion when boosting frequencies.
Completion Rate
How much of a track you typically listen to. Skipping lowers this percentage.
CRT
Cathode Ray Tube. The old TV technology that inspired the app's visual style.
◆═══════════════════◆═══════════════════◆

Getting Help

If you run into problems:

Check this manual first
Make sure you're on the latest version of the app
Note what you were doing when the issue occurred
Include your app version and iOS version when reporting problems