Skip to content

Repository files navigation

🎵 Zarya.nvim

Neovim Lua macOS License

Control Apple Music without leaving Neovim

Installation · Usage · Configuration


Zarya.nvim provides an elegant floating UI for Apple Music inside Neovim — track info, playback controls, volume, and a Telescope-powered playlist picker, all without leaving your editor.


Requirements


Installation

lazy.nvim:

{
  "NoamFav/Zarya.nvim",
  dependencies = {
    "nvim-telescope/telescope.nvim",
    "nvim-lua/plenary.nvim"
  },
  config = function()
    require("apple_music").setup({})
  end,
}

packer.nvim:

use {
  "NoamFav/Zarya.nvim",
  requires = { "nvim-telescope/telescope.nvim", "nvim-lua/plenary.nvim" },
  config = function() require("apple_music").setup() end
}

Usage

Commands

Command Description
:MusicControl Open floating music control UI
:FocusMusicUI Focus / unfocus the floating window
:MusicPickPlaylist Telescope playlist picker

Default Key Mappings

Mapping Action
<Leader>mu Open Music UI
<Leader>mp Play / Pause
<Leader>mn Next track
<Leader>mb Previous track
<Leader>m+ Volume up
<Leader>m- Volume down
<Leader>mq Close UI
<Leader>mm Focus UI
<Leader>pp Pick playlist

Configuration

The UI refreshes every 2 seconds by default — adjustable in the setup options.


License

MIT — see LICENSE.


Made with ❤️ by NoamFav

About

Simple plugin that allows you to control and visualize your music playing on apple music

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages