Welcome to Librarian

Librarian is where your station's music lives. It manages your audio library — organizing songs, keeping track of metadata, setting transition points, and making sure AutoCast always has clean, reliable information to work from. Think of it as the quiet professional behind the scenes who has every record filed, labeled, and ready to go.

Your library is stored as a simple tab-separated file (library.tsv) in your Station Folder. Librarian reads it, displays it, lets you filter and edit it, and writes it back to disk. No cloud, no database server, no subscription required — just a well-organized file that every TuneTracker app knows how to read.

📱

Using Librarian Mobile? Most of this documentation applies equally to Librarian Mobile, with one exception: the Import tab is desktop-only. Librarian Mobile is for managing existing songs in the field — adding new audio to your library still happens at the station on Librarian Desktop.

⚠️

Important for mobile users: Librarian Mobile requires the desktop Librarian app to remain running on your station Mac while you're connected from the field. Be sure to leave Librarian open at the station before you head out.

The Four Tabs

📥

Import

Bring audio files and metadata into your library — from files, from other databases, from filenames, or from embedded tags.

🏷️

Attributes

View and edit song metadata — artist, title, genre, year, and any custom fields your station uses.

🎚️

Transitions

Set EOM, Cue, and Ramp points on songs so AutoCast knows exactly when to start and stop each track.

✨

Touchups

Annotate songs with silence boundaries and broadcast-target loudness so AutoCast plays them cleaner — manually for selections, or automatically by watched folder.

📡

What is TuneTracker Go?

The shell that hosts Librarian Mobile and the helper that runs at your station — what each does, how to keep them happy, and how to ask for help.

How the Window Works

Librarian's window is divided into three vertical panes that work together:

Left pane — Station Folders: The categories in your library, derived from the subfolder names inside your Station Folder's music directory. Click a category to see its songs.
Middle pane — Song List: All songs in the selected category, filterable by up to four criteria at once. This is your working selection — everything you do in the right pane applies to whatever's selected here.
Right pane — Tools: The Import, Attributes, and Transitions tabs live here. What you see depends on what you're trying to do.

💡

You can select multiple songs in the middle pane and edit their attributes all at once. Very handy when you've just imported a batch of tracks that share the same genre or year.

The Status Bar

The black bar at the very bottom of the window does double duty. Hover your mouse over any control and it shows a plain-English description of what that control does — no guessing required. When your mouse isn't hovering over anything, it shows the current state of your library: how many entries are loaded, how many are showing after filtering, and so on.

The gold speaker icon on the left flashes green when something finishes successfully, and red when something needs your attention. If it goes red, read the message before doing anything else — it won't bite, but it does have something important to say.

The "Removed Entries" Message

From time to time, you may see a black panel appear over the waveform area listing files that have been removed from the database. Don't panic — this is completely normal and not an indication that anything has gone wrong.

Every time Librarian loads your library, it checks that each entry still has a corresponding audio file on disk. If a file has been moved, renamed, or deleted since the last time you used Librarian, the entry is quietly removed from the database and listed in this message so you know what changed. No files are deleted — the message is simply letting you know that something that was in the library no longer appears to be available.

Common reasons this happens:

You reorganized your Station folder and moved files to different subfolders.
You deleted some songs you no longer wanted.
A file was renamed outside of Librarian.
An external drive or network share containing audio files wasn't mounted when Librarian loaded.

If the files were moved intentionally, just dismiss the message and carry on. If something looks wrong — for example, a large number of files disappeared unexpectedly — check that your Station folder path in Preferences is still correct and that any external drives are connected.

Your Station Folder

This is the single most important concept in the TuneTracker System: every audio file you plan to use in your station must live inside your Station folder. Not just for Librarian's sake — every app in the suite (AutoCast, MakeMyDay, TuneStacker, and the rest) looks inside the Station folder to find your audio. If a file isn't there, it doesn't exist as far as the system is concerned.

When you first set up the TuneTracker System, you chose a location for your Station folder. Inside it, you'll find subfolders for Music, Commercials, Jingles, Promos, Sweepers, Liners, Programs, and more. Your audio files go into those subfolders — that's how Librarian organizes them into categories, and how AutoCast knows where to find them during a broadcast.

Files stored on your Desktop, in your Downloads folder, on a thumb drive, or anywhere else outside the Station folder will not be seen by the TuneTracker apps. If you want to use a file, move or copy it into the appropriate subfolder of your Station folder first, then let Librarian import it into the library.

⚠️

Keep it all in one place. Scattering audio files across multiple locations is the number one cause of missing-file errors, broken playlists, and dead air. Your Station folder is home base — if it's not in there, it's not in your station.

📁

Your library file lives at {StationFolder}/Logs/Database/library.tsv. Librarian keeps five rolling backups automatically, so if something ever goes sideways, your data isn't far away.

Keyboard Shortcuts

Shortcut	What it does
`Space`	Toggle playback on the Transitions tab.
`E`	Drop an EOM marker at the current playback position.
`C`	Drop a Cue marker at the current playback position.
`R`	Drop a Ramp marker at the current playback position.
`Escape`	Clear markers and reset the waveform display.
`↑` `↓`	Navigate the song list (stops playback first, so you don't accidentally audition twelve songs at once).
`⌘A`	Select all songs in the current view.
`⌘L`	Apply attribute changes (same as clicking the Apply button).
`⌃↩`	Apply attribute changes — alternate shortcut.

A Typical Workflow

If you're new to Librarian, here's how things usually go:

Import your audio files — Use the Import tab's "See This First" wizard. It walks you through picking files, choosing where they go, and getting them into the library.
Clean up metadata — Head to Attributes to fill in artists, titles, genres, and any other fields your station cares about. The filter system in the middle pane makes it easy to work on groups of songs at once.
Set transition points — Use the Transitions tab to mark where each song's EOM, Cue, and Ramp points are. AutoCast uses these to make your segues sound natural rather than abrupt.
Touchups for clean, consistent on-air sound — On the Touchups tab, scan your songs for leading and trailing silence and for integrated loudness. AutoCast reads the resulting values at playback time, trims dead air at the head and tail of each file, and SteadyCast™ applies a per-song gain so every song hits your station's target loudness — without ever modifying your audio files. Run it manually with By Selection, or set up watched-folder rules with By Folder to handle ongoing arrivals automatically.
Let AutoCast take it from here — Once your library is in good shape, the rest of the TuneTracker suite can do its job properly. A well-tended library makes everything downstream work better.