Skip to content

The amp# main window

Petteri Kautonen edited this page Dec 26, 2022 · 6 revisions

The amp# main window

The main window consists of the menu, playback controls, album selector, volume, rating, position, search, track list, audio visualization and status bar.

image

The menu

The File menu

Add music files...

  • Add files to album...: This opens a select file dialog with multiple selection to the current album.

  • Add folder contents to album...: This opens a select folder dialog to select a folder which music files to recursively add to the current album.

Album

This opens a dialog to manage the albums within the program database.

Track information

Opens a dialog to display and manage the currently selected track metadata (IDvX, etc). Also a track image can be set from track information. Keyboard shortcut: F4.

Quit

Exists the program. Keyboard shortcut: Ctrl+Q or +Q

The queue menu

Save current queue

Opens a dialog to allow user to specify a name for the current queue or alternate queue to save so it can be loaded and played back again when the user wishes to do so. Keyboard shortcut: Ctrl+S or +S.

Saved queues

Opens a dialog where saved queue snapshots can be loaded, edited and deleted. Keyboard shortcut: F3.

Clear queue

Clears the queued tracks from the current album. Keyboard shortcut: Ctrl+D or +D.

Scramble queue

Re-randomizes the current queue playback order. If two or more queued items are selected, only the selection is re-randomized. Keyboard shortcut: F7.

Stash current queue

Saves to current queue into the stash clearing the current queue in the process. The function can be used to listen something else in between the current queue playback. Keyboard shortcut: Ctrl+T or +T.

Pop stashed queue

Restores the stashed queue overriding the current queue in the process. Keyboard shortcut: Ctrl+P or +P.

The Tools menu

Settings

Opens the settings dialog for various software settings.

Color settings

Opens a dialog where the software colors can be set.

Icon settings

The icon settings dialog allows user to specify SVG images as custom UI icons.

Update track metadata

Goes through all the tracks in all albums and reads the track file metadata and updates it to the corresponding record of software. This tool is designed to be used if the track metadata is modified elsewhere as the amp# only reads the metadata tags once.

The Help menu

About

Displays an about dialog for version and license information of the application.

Help

This help is displayed via web browser. Keyboard shortcut: F1.

Check for new version

Checks if a new version of the amp# software is available for download and:

  • If one is available the user is displayed a dialog with changes compared to the current version and a clickable link to the download web page.
  • If no new version is available a dialog informing about that is displayed.

Playback toolbar

The playback toolbar contains typical playback controls and few mode settings.

image

The previous track button - Plays the previous track if there is one in the history.

image

The play/pause button - Resumes or pauses the playback.

image image

The next track button - Plays the next track. The next track depends on if there are tracks queued, shuffle and repeat modes.

image

The show queue toggle button - Filters the task list by queued tracks. If nothing is queued, the track list will be empty. Searching via text can also be applied to the track list filtered by queue.

image

The shuffle toggle button - Toggles the playback randomization.

image

The repeat toggle button - Toggles to playback repeat. E.g. continuous playback.

image

The toggle stack queue button - The stack queue mode ensures that the queue never ends. The played tracks just are moved to the back of the queue and a defined part of the queue is re-randomized.

image

Album selector

The album can be changed from the album selector. The previous album is automatically saved before an album is changed.

image

Sound and rating

The volume slider The volume slider controls the main volume of the playback. The volume level has no effect on the system volume setting.

The audio track volume slider The audio track volume slider controls the volume of an individual audio track playback. This value is saved to the internal database of the software. Multiple selection volume can be updated using the Ctrl or modifier key.

The rating slider With the rating slider the track can be given a rating. This value is saved to the internal database of the software. Multiple selection rating can be updated using the Ctrl or modifier key.

The position slider

The position slider allows to control the playback position of the current track.

Current track title and duration

The duration displays the time left to playback the track. By clicking the track title you can focus on the current track in the track list.

The search box

The search box allows to filter the tracks from the current album. The search is directed to all the properties of the audio track:

  • Tag data

    • Year
    • Album
    • Artist
    • File tag contents including possible lyrics
    • Etc...
  • File name

The search box is focused when the main window is active and characters are written, so the search does not need to be explicitly focused by mouse or by keyboard. Just type!

Use Escape key to clear the search box.

The track list

The track list contains all the tracks in the current album. It also has columns to indicate the index in the queue titled Q and a column to indicate the alternate queue index titled *. The columns can be re-ordered and the ordering is saved into the application settings.

Tracks can be added to queue using the + key or inserted on top of the queue using Ctrl++ or ++.

Tracks can be added to the alternate queue using the * key or inserted on top of the queue using Ctrl+* or +*.

The reason for the alternate queue is to allow to create a new queue to save while listening to music and possibly queuing new tracks to playback.

The status panel

The status panel at the bottom of the main displays the number of queued tracks, the number of filtered tracks and the number of total tracks within the album.