am
A beautiful and feature-packed Apple Music CLI!
Written in Rust.
Installation
Nix (recommended)
This GitHub repository contains a flake. Add github:ryanccn/am to your flake inputs:
{
inputs = {
# ...other inputs
am = {
url = "github:ryanccn/am";
inputs.nixpkgs.follows = "nixpkgs";
}
}
}
Then, use the overlay from overlays.default and add am to your packages. Alternatively, you can use packages.default directly.
Cargo
You can install (the cutting-edge version of) am through cargo.
$ cargo install --git https://github.com/ryanccn/am.git
Manual download
Download the aarch64 (Apple Silicon) or the x86_64 (Intel) version of the binary.
Dequarantine them with xattr -d com.apple.quarantine <path> and make them executable with chmod +x <path>.
Features
- Beautiful now playing display
- Playback controls (play, pause, toggle, resume, back, forward, next, previous)
- Discord rich presence
- Launch agent installation
- Shell completions
Screenshots
am now
am next
am discord
Discord presence launch agent
Through a macOS launch agent, the Discord rich presence can be made to run in the background as long as you are logged in.
Standard installation
You can install the Discord presence as a launch agent by running am discord install. Note that this depends on the executable/symlink staying in the same place; if it moves to a different place, run the command again.
The am process running in the launch agent will log to ~/Library/Logs/am-discord-rich-presence.log.
You can uninstall the launch agent with am discord uninstall.
Home Manager
This repository's flake also provides a Home Manager module at homeManagerModules.default. This module exposes a service am-discord-rich-presence that you can enable.
{
services.am-discord-rich-presence = {
enable = true;
# optional
# logFile = "${config.xdg.cacheHome}/am-discord-rich-presence.log";
}
}
Thanks to...
- Raycast's Apple Music extension for a helpful reference of Apple Music's AppleScript interface usage
- sardonicism-04/discord-rich-presence for the original Rust crate for connecting to Discord
- caarlos0/discord-applemusic-rich-presence for inspiring the Discord presence part of this CLI
License
GPLv3
43 Oct 31, 2022
7 Jul 23, 2023
26 Nov 22, 2022
238 Jan 4, 2023
18 Nov 21, 2023
9 Jun 11, 2022
70 Apr 14, 2023
10 Jul 12, 2023
525 Jan 8, 2023
13 Jun 26, 2023
105 Oct 10, 2023
11 Sep 4, 2023
60 Dec 29, 2022
15 Dec 15, 2022
34 Apr 17, 2023
6 Oct 27, 2023
162 Dec 31, 2022
574 Jan 5, 2023
3 Nov 10, 2022