Skip to content
master
Switch branches/tags
Code

App demo

Table of Contents

Overview

Aural Player is an audio player for macOS. Inspired by the classic Winamp player for Windows, it is designed to be easy to use and customizable, with support for a wide variety of popular audio formats and powerful sound tuning capabilities.

Flexibility Personalization
With Winamp-like modularity and multiple app presentation modes, you can lay out the app to suit your workspace or tuck it away in the macOS menu bar. Personalize Aural Player with exactly the colors and fonts that define your creative tastes.
Extensive Audio Formats Support Sound tuning and monitoring
By harnessing the power of FFmpeg, Aural Player supports a wide variety of popular audio formats, in addition to all macOS Core Audio formats. With several built-in effects and support for Audio Units (AU) plug-ins, sound tuning and monitoring possibilities are endless.

How it works (under the hood)

Aural Player is written entirely in Swift (approximately 100,000 lines of code). It uses AVFoundation's AVAudioEngine framework (and some low-level Core Audio) for playback, effects, and visualization, and uses FFmpeg libraries to decode formats not native to macOS.

How it works screenshot

Read more about it here.

Key features

(Comprehensive feature list here)

  • Supports all Core Audio formats and several non-native formats: (including FLAC, Vorbis, Monkey's Audio (APE) & more)
  • Supports M3U / M3U8 playlists
  • Playback: Bookmarking, segment looping, custom seek intervals, last position memory, chapters support, autoplay.
  • Effects: Built-in effects (incl. equalizer), Audio Units (AU) plug-ins support, built-in / custom presets, per-track settings memory.
  • Playlist: Grouping by artist/album/genre, searching, sorting, type selection.
  • Information: ID3, iTunes, WMA, Vorbis Comment, ApeV2, etc. Cover art (with MusicBrainz lookups), lyrics, file system and audio data. Option to export.
  • Track lists: Favorites list, recently added and recently played lists.
  • Visualizations: 3 different visualizations that dance to the music, with customizable colors.
  • UI: Modular interface, fully customizable fonts and colors, built-in / custom window layouts, menu bar mode, control bar (widget) mode.
  • Usability: Configurable media keys support, swipe/scroll gesture recognition, remote control from Control Center, headphones, media control devices / apps).

Roadmap

The following features may be implemented in the future:

  • A file browser.
  • Allow for multiple playlists.
  • A single window "Unified" user interface mode.
  • A nicer playlist UI with customizable columns and a "tiles" view.
  • Replay gain.
  • Crossfading between tracks.
  • Gapless playback.

Other goals

  • More extensive unit testing.
  • More comprehensive documentation.
  • Better source code commenting.

Download

Latest release

See all releases

Compatibility

This table lists the minimum required Aural Player version for your hardware and macOS version. It is always recommended to use the latest app version, regardless of your hardware / macOS version.

Intel (x86_64) Apple silicon (arm64)
macOS 10.12 - 10.15 1.0.0 (N/A)
macOS 11.x (Big Sur) 2.3.0 3.0.0

NOTE: Version 3.0.0 and all subsequent releases are universal binaries, i.e. capable of running on both Intel and M1 Macs.

Installation

  1. Mount the AuralPlayer-x.y.z.dmg image file.
  2. From within the mounted image, copy Aural.app to your local drive (e.g. Applications folder).
  3. Run the copy from your local drive. You will likely see a security warning and the app will not open because the app's developer is not recognized by macOS.
  4. Go to System Preferences > Security & Privacy > General > Open anyway, to allow Aural.app to open.

NOTE - Please don't run the app directly from within the image. Copy it outside and run the copy.

Enabling media keys support (optional)

Follow the steps listed here.

Important note for anyone upgrading from v2.2.0 (or older) to v2.3.0 or newer app versions

Please read this important note, otherwise you will lose your previous app settings.

Building the app

All you need is Xcode 12.2+ and the source code (a working knowledge of Swift would help !). It is recommended to use the source code from the latest release (as opposed to the master branch) as code between releases can be buggy / unstable.

Read the quick start guide for more details.

Documentation

All the documentation can be found on the wiki.

Some pages to get you started

How To's

Handy keyboard shortcuts

Building and running Aural Player (quick start guide)

Developer reference

Screenshots

"Lava" color scheme, "Futuristic" font scheme, default window layout

Vertical full stack window layout screenshot

Hosting Audio Units (AU) plug-in "TDR Nova" Equalizer by Tokyo Dawn Labs

Audio Units demo GIF

Running in Menu Bar mode

Menu Bar Player screenshot

Running in Control Bar mode

Control Bar Player screenshot

Control Center integration (macOS Big Sur)

Control Center integration 1 screenshot

Control Center integration 2 screenshot

Font schemes

Font schemes demo

Color schemes

Color schemes demo

Customizing the player view

Player view

Enabling and disabling effects

Enabling and disabling effects demo

Segment loop playback

Segment loop playback demo

Detailed track info

Detailed track info

Changing the window layout

Changing the window layout demo

Visualizer

Known issues (and solutions)

Contact and conversation

I encourage you to provide feedback or start a conversation about features you'd like to see implemented, bugs you've encountered, or suggestions for improvement.

Twitter: https://twitter.com/AuralPlayer. I will try to post informal updates there.

Email: aural.student@gmail.com

GitHub Issues https://github.com/maculateConception/aural-player/issues. I'm usually pretty good at responding to issues, even if I'm not always able to fix them.

Third party code attributions

  • FFmpeg (used to decode audio formats not natively supported on macOS)
  • MediaKeyTap (used to respond to media keys)
  • RangeSlider (used in the Filter effects unit to specify frequency ranges)

Contributor attributions

App user yougotwill made numerous suggestions for improvements and features, provided a lot of valuable feedback, and designed the Poolside.fm theme.

Fellow GitHub member dun198 made significant contributions towards this project - performance optimizations, UX improvements, etc.

License

Aural Player (in both forms - source code and binary) is available for use under the MIT license.