https://github.com/ryanccn/am
A beautiful and feature-packed Apple Music CLI
https://github.com/ryanccn/am
apple apple-music applescript clap clap-rs cli hacktoberfest macos rust tui
Last synced: 2 months ago
JSON representation
A beautiful and feature-packed Apple Music CLI
- Host: GitHub
- URL: https://github.com/ryanccn/am
- Owner: ryanccn
- License: gpl-3.0
- Created: 2023-09-05T15:06:26.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-06T14:44:18.000Z (3 months ago)
- Last Synced: 2025-04-06T14:45:28.311Z (3 months ago)
- Topics: apple, apple-music, applescript, clap, clap-rs, cli, hacktoberfest, macos, rust, tui
- Language: Rust
- Homepage:
- Size: 403 KB
- Stars: 21
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `am`
A beautiful and feature-packed Apple Music CLI, written in [Rust](https://www.rust-lang.org/).
## Installation
### Cargo
You can install `am` with `cargo install` or `cargo binstall` from crates.io.
```bash
cargo binstall am
```
### Nix
This GitHub repository contains a flake. Add `github:ryanccn/am` to your flake inputs:
```nix
{
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`](https://github.com/ryanccn/am/releases/latest/download/am-aarch64-apple-darwin) (Apple Silicon) or the [`x86_64`](https://github.com/ryanccn/am/releases/latest/download/am-x86_64-apple-darwin) (Intel) version of the binary.
Dequarantine them with `xattr -d com.apple.quarantine ` and make them executable with `chmod +x `.
## 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.
```nix
{
services.am-discord = {
enable = true;
# logFile = "${config.xdg.cacheHome}/am-discord.log";
}
}
```
## Thanks to...
- [Raycast's Apple Music extension](https://github.com/raycast/extensions/tree/main/extensions/music) for a helpful reference of Apple Music's AppleScript interface usage
- [sardonicism-04/discord-rich-presence](https://github.com/sardonicism-04/discord-rich-presence) for the original Rust crate for connecting to Discord
- [caarlos0/discord-applemusic-rich-presence](https://github.com/caarlos0/discord-applemusic-rich-presence) for inspiring the Discord presence part of this CLI
- [@ajaxm](https://github.com/ajaxm) for ceding ownership of the `am` package on crates.io
## License
GPLv3