Skip to content

seedy60/APMBrowser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

APM Browser

Browse, search and play production music from APM, KPM, Juice Music and more via the Extreme Music library.

Introduction

APM Browser is a lightweight desktop client for Extreme Music, one of the world's largest production music libraries. If you've heard a piece of music either in an advert, as a radio/TV show theme tune or in a movie, no doubt it'll be on Extreme Music. This program gives you the same search, browse and playback features of the official website in a clean, Screen reader friendly interface.

Features

  • Search for tracks or albums across the entire Extreme Music catalogue.
  • View album track listings and all available versions of a track (full version, 30 seconds, instrumental, etc.).
  • Stream tracks directly with near-instant playback.
  • Download tracks as MP3 files.
  • Page through large result sets with previous and next page buttons.
  • All on-screen elements, such as buttons, lists and text fields, are clearly labelled for screen reader users.
  • Keyboard friendly navigation with tab, arrow keys, enter and space bar.

Installation

From source

The following instructions detail how to download and run APM Browser from its source code on Windows.

  1. Press Windows + R, type powershell and hit enter.
  2. Install UV, a fast, modern package manager for Python.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  1. Use UV to install Python if it is not already installed.
uv python install
  1. Clone the repository and switch to its directory.
git clone https://github.com/seediffusion/APMBrowser.git
cd APMBrowser
  1. Install the required libraries.
uv sync
  1. Run the program.
uv run python apm.py

Pre-compiled

  1. Download the latest release.
  2. Extract the zip file with your zip archiver of choice.
  3. Navigate to the extracted program folder and run apm.exe. If file extensions don't show on your system, the filename will just be apm.

Usage

Searching

  1. Run the program. Focus will land in the search field.

  2. Type a search term, for example rock, epic or jazz, or a specific album name, such as childs play or mixed bag, or the name of a track, such as Night Owl, Take it Down, Global Report or Teepee.

    [!NOTE] Fun fact: Global Report is actually the name of the ITV News at Ten theme from 2008. It is part of the Classic Television and Radio Themes (TV) album if you want to find it for your nostalgia.

  3. Tab to the search type dropdown and choose between Tracks and Albums.

  4. Press enter or click the Go button to search.

  5. Results appear in the list below. Use the up and down arrow keys to browse them.

Note: it can sometimes take a while for search results to appear depending on the number of search results, the number of tracks in an album etc.

Viewing track versions

  1. Search for tracks and select one from the results list.
  2. Press enter to load all available versions. They appear in the track versions list below.
  3. Use the up and down arrow keys to browse versions such as Full Version, 30 Seconds, Instrumental and so on.

Viewing album tracks

  1. Search for albums and select one from the results list.
  2. Press enter to load all tracks in the album. They appear in the track versions list below.

Playing a track

There are several ways to play a track:

  • Select a version in the track versions list and press enter or space to play it.
  • Click the Play button to play the selected version.
  • Press space in the search results list to quick-play a track result without loading its versions first.
  • Press space again to pause and resume playback.

The current playback position and track title are shown at the bottom of the window.

Downloading a track

  1. Select a track version or a track search result.
  2. Click the Download button or press Ctrl + D.
  3. Choose a location and filename in the Save As dialog. A sensible default filename is suggested.
  4. Download progress is shown in the status bar as a percentage.

Keyboard shortcuts

  • Ctrl + F: Jump to the search field.
  • Ctrl + D: Download the selected track.
  • Enter: Activate the selected item (load versions, load album, play version).
  • Space: Play, pause or resume playback.
  • Tab / Shift + Tab: Move between controls.
  • Alt + letter: Activate buttons by their underlined letter (S for Search, G for Go, P for Play, T for Stop, D for Download, etc.).

About

Browse, search and play production music from APM, KPM, Juice Music and more via the Extreme Music library.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors