Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 3 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 (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-14T10:55:49.000Z (3 months ago)
- Last Synced: 2024-10-19T16:49:02.966Z (3 months ago)
- Topics: apple, apple-music, applescript, clap, clap-rs, cli, hacktoberfest, macos, rust, tui
- Language: Rust
- Homepage:
- Size: 369 KB
- Stars: 13
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
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
### Nix (recommended)
This GitHub repository contains a flake. Add `github:ryanccn/am` to your flake inputs:
```nix
{
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,am}` directly.
### Cargo
You can install `am` through `cargo` from crates.io.
```console
$ cargo install am
```
### 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)
- 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.
```nix
{
services.am-discord-rich-presence = {
enable = true;
# optional
# logFile = "${config.xdg.cacheHome}/am-discord-rich-presence.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