Home
This guide will help you get started with setting up Petrichor!
Note: Screenshots may be outdated, but overall feature details are still kept up-to-date.
- macOS 14.0 (Sonoma) or later
- Apple Silicon (M series chips) or Intel processor
- Go to Releases and download the latest
.dmg. - Open the it and drag the app icon into the Applications folder.
- In Applications, right-click Petrichor > Open.
brew install --cask petrichor
Petrichor supports over 20 audio file formats and should handle most of your audio files without problems.
When you launch Petrichor for the first time, you'll be presented with a view
to add Folders to library using Add Music Folder button
Once the folder(s) are added, app will start scanning your folders where it;
- Scans through all the available tracks, identifying supported ones
- Extracts metadata including title, artist, album, genre, year, and album artwork
- Sets up music database with the extracted information
- Finally, loads up music library at the end of scanning
In case your folders include files that are not supported by Petrichor yet or failures to scan certain files, app will notify you about the same at the end of scanning.
Once you're presented with your music library at the end of scanning your folders, you'll see app window that includes various elements.
The Home tab is your music dashboard, featuring:
- Discover - Contains list of tracks you've never played (or played a long time ago)
- Tracks - List of all the tracks present in your library
- Artists - List of individual Artists
- Albums - List of individual Albums
- Pinned items - Anything you've pinned to Home, by default you'll see some of the playlists pinned here
The Library tab provides organized view to access to your music, here you have more granular access to your tracks by categorizing it using various categories like following;
- Artists - All artists in your library
- Albums - Complete album listing
- Genres - Music organized by genre
- Years - Browse by release year
- Decades - Group by decade
- Composers - Classical music organization
You can filter list of items, or pin them to home by right clicking any item
The Playlists tab provides you ability to create custom playlists, additionally, it includes 3 specialized playlists by default;
- Favorites - Tracks you've marked with a ⭐
- Top 25 Most Played - Your most frequently played songs (5+ plays)
- Top 25 Recently Played - Songs played in the last week
To create custom
- Click the "+" button in the Playlists section
- Provide playlist name in the dialog that shows up
- Click
Add songsbutton and then once sheet opens, search for tracks you want to add.
- You can add multiple tracks by searching using various keywords and adding tracks
If your music files are organized via a specific folder structure and you prefer to browse it via the same, you can do that from Folders tab.
Note: The Folders tab is hidden by default. Enable it via View → Show Folders Tab
Your added folders are directly accessible from the sidebar and can be expanded on click, in case a folder includes tracks list, it'll show up when that folder itself is selected.
The player bar at the bottom provides traditional playback controls along with ability to;
- Wiew track information by clicking album art
- Adding track to favorites by clicking ⭐
- Opening current playback queue
You can control audio effects using Equalizer, and it can be opened from Window menu of the app, or by pressing keyboard shortcut ⌘+⌥+E.
The Equalizer includes support for;
- Adjustable Preamp
- 10-band gain values
- Stereo Widening
- Includes 23 presents
Besides presents, you can also maintain a custom setting of gains as you like.
The playback can also be controlled via keyboard shortcuts as follows;
- Space - Play/Pause
- ⌘+→ - Next track
- ⌘+← - Previous track
- ⇧+⌘+→ - Seek Forward
- ⇧+⌘← - Seek Backward
- ⌘+↑ - Increase Volume
- ⌘+↓ - Decrease Volume
You can hide/show columns by right-clicking column headers, and can also rearrange columns by dragging around the header of that column:
You can order tracks by different attributes and even expand or collapse rows (collapsing hides album art) using menu in the header:
Right-click any track to access:
- Play - Playing the track
- Play Next - Queue track after current
- Add to Queue - Add to end of playback queue
- Show info - View track details in the sidebar
- Reveal in Finder - Open Finder and view track file
- Go to - Pin-point selected to list of tracks in Library tab based on selected context
- Add to playlist - Add track to selected playlist
- Add/remove to/from Favorites - Adding track to (or remove from) Favorites
Access settings via Petrichor → Settings or ⌘+,
-
Behaviour
- Start at Login - Start Petrichor when macOS starts
- Keep running in menubar on close - Keep Petrichor running in the background even when app window is closed
- Hide duplicate songs - Prevent duplicate tracks from showing up in library
- Check for updates automatically - Keep Petrichor up-to-date with new releases
-
Appearance
- Color mode - Set dark mode to be manual or automatic
- Show folders tab in main window - Show Folders tab to browse library using folder structure as present in filesystem
-
Library
- Auto-scan library every - Auto-scan added library folders for updates based on selected intervals
- Refresh Discover every - Refresh songs showed in Discover section based on selected intervals
- Number of Discover tracks - Total tracks to include in Discover section
Adding or removing library folders, refreshing added folders or reset library data
View app information:
- Current version and build number
- Library statistics
- Useful links
- GitHub Issues - Report bugs or request features
- Discussions - Join the community conversation or ask questions about the app
Last updated for Petrichor version 1.0.0