am

A beautiful and feature-packed Apple Music CLI, written in Rust.

Installation

Cargo

You can install am with cargo install or cargo binstall from crates.io.

cargo binstall am

Nix

This GitHub repository contains a flake. Add github:ryanccn/am to your flake 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,am} directly.

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)
• Song.link generation
• Discord rich presence
• Launch agent installation
• Shell completions

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.log.

You can uninstall the launch agent with am discord uninstall.

Home Manager

This repository's flake also provides a Home Manager module at homeModules.am-discord. This module exposes a service am-discord that you can enable.

{
  services.am-discord = {
    enable = true;
    # logFile = "${config.xdg.cacheHome}/am-discord.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
• @ajaxm for ceding ownership of the am package on crates.io

License

GPLv3