https://github.com/lukakerr/plyr

A hyperminimal, lightweight macOS desktop music application
https://github.com/lukakerr/plyr

macos minimal music music-player osx swift

Last synced: about 1 year ago
JSON representation

A hyperminimal, lightweight macOS desktop music application

• Host: GitHub
• URL: https://github.com/lukakerr/plyr
• Owner: lukakerr
• License: apache-2.0
• Created: 2018-03-01T05:55:10.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2020-05-29T03:57:32.000Z (almost 6 years ago)
• Last Synced: 2025-03-21T18:13:37.415Z (about 1 year ago)
• Topics: macos, minimal, music, music-player, osx, swift
• Language: Swift
• Homepage:
• Size: 356 KB
• Stars: 52
• Watchers: 3
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Plyr

[![Swift 5](https://img.shields.io/badge/swift-5-orange.svg?style=flat)](https://github.com/apple/swift)

[![Platform](http://img.shields.io/badge/platform-macOS-red.svg?style=flat)](https://developer.apple.com/macos/)

[![Github](http://img.shields.io/badge/github-lukakerr-green.svg?style=flat)](https://github.com/lukakerr)

![Github All Releases](https://img.shields.io/github/downloads/lukakerr/plyr/total.svg)



  



Plyr is a hyperminimal, lightweight macOS music playback desktop application.

Audio files are looked for in the `~/Music` directory. If none are found, the app will notify you and terminate.

### Installing

#### Install via Homebrew Cask

```bash

$ brew tap lukakerr/things

$ brew cask install plyr

```

#### Manual Download

Visit the [releases page](https://github.com/lukakerr/plyr/releases) to download manually.

### Uninstalling

#### Download via Homebrew Cask

```bash

$ brew cask remove plyr

```

#### Downloaded Manually

```bash

$ rm -r /Applications/Plyr.app ~/Library/Caches/io.github.lukakerr.plyr

```

### Features

- Pause or play

- Skip or rewind 10 seconds

- Skip to next or previous song

- Minimal UI

### Todo

- Add UI preferences

  - [ ] Window border radius

  - [ ] Show or hide traffic lights

  - [ ] Light or dark overlay

- Add functionality preferences

  - [ ] Duration to skip or rewind

- Add functionality

  - [x] Show quick open panel to search for and play songs

  - [x] Add keybindings for play, pause, skip, rewind, next and previous buttons

### Screenshots