Skip to content

Repository files navigation

Luna Player

A fast audio and video player for Windows with speech announcements and configurable keyboard shortcuts.

Playback state, file information and setting changes are announced through speech. Actions are driven by keyboard shortcuts, and each one can be reassigned.

Status

Luna Player is under active pre-1.0 development. Features, keyboard shortcuts, settings and configuration file formats may change between releases without notice, and saved settings are not guaranteed to carry forward. Bug reports are welcome.

Features

Playback

  • Play, pause and seek, with a seek step selectable from eleven presets or a custom value
  • Playback speed from 0.5x to 6x, with a configurable step
  • Volume up to 1000%, with a limiter to prevent clipping
  • A–B loop for repeating a section
  • Shuffle and repeat-file
  • Configurable end-of-file behaviour: advance to the next file, loop, or stop and hold position

Audio processing

  • Dynamic normalization with a limiter, for recordings with inconsistent levels
  • Mono downmix
  • Silence removal, with threshold and duration settings and a full set of advanced parameters

Navigation

  • Named bookmarks, with ten directly addressable slots
  • Per-file position memory, and optional restore of the last session on startup
  • Go to a specific time, or jump to a percentage of the file
  • Opened files list, and a playlist summary reporting file count, total size, duration, elapsed and remaining time

File management

  • Open a single file, a folder, or a folder and its subfolders
  • Mark multiple files, then copy, move, delete, or copy them to the clipboard as a batch
  • Rename and delete the current file
  • Register Luna Player as a handler for supported file types

Speech and input

  • Spoken announcements for playback, navigation and setting changes
  • Two verbosity levels: full messages, or short ones
  • Optional announcement of the file name when moving between tracks
  • Primary and secondary shortcuts for actions, all reassignable
  • Context-sensitive help in the settings dialog: press F1 on a control to hear what it does

Windows integration

  • System Media Transport Controls: title and playback position appear in the Windows media overlay
  • Hardware media key support
  • Output device selection

Requirements

  • Windows 10 version 1809 (build 17763) or later, 64-bit

Installation

Download the latest release from the Releases page and follow the instructions for the package you choose.

Default shortcuts

Shortcut Action
Space Play / pause
Left / Right Seek backward / forward
Up / Down Volume up / down
Ctrl+Up / Ctrl+Down Speed up / down
Tab / Shift+Tab Next / previous track
F Announce current file
E / R / T Announce elapsed / remaining / total time
[ / ] Set A–B loop start / end
Shift+M Add bookmark
Ctrl+M Toggle silence removal
Ctrl+O Open file
Ctrl+P Settings

The complete list is in Settings → Keyboard Shortcuts, where any shortcut can be reassigned.

Supported formats

Audio: AAC, AC-3, AIFF, ALAC, APE, AU, DTS, E-AC-3, FLAC, M4A, MKA, MP1, MP2, MP3, MPC, OGA, OGG, OGM, Opus, TAK, TrueHD, TTA, WAV, WMA, WavPack

Video: 3G2, 3GP, AVI, FLV, IVF, M2TS, M4V, MJ2, MKV, MOV, MP4, MPEG, MPG, MXF, OGV, RMVB, TS, WebM, WMV, Y4M

Playlists: M3U, M3U8 (including HLS)

Playback is handled by mpv, so most formats it supports will play.

Building from source

Requires the .NET 10 SDK and Visual Studio Build Tools with the MSVC x64 toolchain.

git clone --recurse-submodules https://github.com/diamondStar35/luna_player
cd luna_player
dotnet build src/LunaPlayer.csproj

See CONTRIBUTING.md for full build instructions and known issues.

Credits

Luna Player is an independent C# application inspired by Simple Audio Player by kamalyaser31. The original project inspired Luna's initial feature set and interaction model, but Luna does not incorporate source code or assets from Simple Audio Player. Its implementation, architecture and user interface have since developed independently.

Contributing

Pull requests are welcome. Please read CONTRIBUTING.md before submitting one.

License

Luna Player's original source code is licensed under the Apache License 2.0. The translated mpv binding is licensed under the GNU Lesser General Public License, version 2.1 or later.

The application also uses separately licensed third-party components. NOTICE records their copyrights, versions and source locations, and their licence texts are installed with the program.

About

An accessible media player for Windows

Resources

Contributing

Stars

12 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages