Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mischah/itunes-remote
:notes: Control iTunes via CLI
https://github.com/mischah/itunes-remote
Last synced: 6 days ago
JSON representation
:notes: Control iTunes via CLI
- Host: GitHub
- URL: https://github.com/mischah/itunes-remote
- Owner: mischah
- License: mit
- Created: 2015-10-28T21:38:01.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2020-03-27T15:43:49.000Z (almost 5 years ago)
- Last Synced: 2024-12-29T20:39:07.469Z (13 days ago)
- Language: JavaScript
- Homepage:
- Size: 5.38 MB
- Stars: 427
- Watchers: 13
- Forks: 31
- Open Issues: 11
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- License: license
Awesome Lists containing this project
- awesome-nodejs-cn - itunes-remote - 交互式控制 iTunes (包 / 命令行程序)
- awesome-cli-apps - itunes-remote - Control iTunes via CLI. (Entertainment / Music)
- fucking-awesome-cli-apps - itunes-remote - Control iTunes via CLI. (Entertainment / Music)
- awesome-nodejs - itunes-remote - Control iTunes via CLI - ★ 345 (Command-line apps)
- awesome-node - itunes-remote - Interactively control iTunes. (Packages / Command-line apps)
- awesome-nodejs-cn - itunes-remote - 交互式控制iTunes. (目录 / 命令行应用)
README
[![npm version](https://img.shields.io/npm/v/itunes-remote.svg?style=flat)](https://www.npmjs.org/package/itunes-remote)
[![Coverage Status](https://coveralls.io/repos/mischah/itunes-remote/badge.svg?branch=master&service=github)](https://coveralls.io/github/mischah/itunes-remote?branch=master)
[![devDependency Status](https://david-dm.org/mischah/itunes-remote/dev-status.svg)](https://david-dm.org/mischah/itunes-remote#info=devDependencies)
[![Dependency Status](https://david-dm.org/mischah/itunes-remote/status.svg)](https://david-dm.org/mischah/itunes-remote#info=Dependencies)
[![Unicorn approved](https://img.shields.io/badge/unicorn-approved-ff69b4.svg?style=flat)](https://www.youtube.com/watch?v=ihXfH-zR8qA&feature=youtu.be&t=10s)
[![Mentioned in Awesome Node.js](https://awesome.re/mentioned-badge.svg)](https://github.com/sindresorhus/awesome-nodejs)# itunes-remote
> Control iTunes via your terminal :notes:
Using [JXA](https://developer.apple.com/library/mac/releasenotes/InterapplicationCommunication/RN-JavaScriptForAutomation/Articles/Introduction.html) via [osascript](https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man1/osascript.1.html) via Node.js.
## Requirements
- Node.js (v0.12.7 or greater)
- Mac OS X (Yosemite 10.10.0 or greater)
- Some tracks in your iTunes library## Demo
![demo](demo.gif)## Install
```
$ npm install --global itunes-remote
```## Usage
It’s interactive and offering an own prompt.
```
$ itunes
iTunes: helpCommands:
help [command...] Provides help for a given command.
exit Exit itunes-remote.
play Start playing the current selection
play artist Plays songs by an artist.
play album Plays an album.
stop Stop playing the current selection
pause Pause playing the current selection
next Advance to the next track in the current playlist.
previous Return to the previous track in the current playlist.
back Reposition to beginning of current track or go to previous track if already at
start of current track.
search [options] Fuzzy search album, artists and songs.iTunes:
```**Note:**
You can also pass commands and options from the outside.```
$ itunes stop --exit
iTunes:
✔ Stopped playing ♪♬
$
```## Thanks
Special shoutout to [@dthree](https://github.com/dthree) for his nice way to offer support for [vorpal](https://github.com/dthree/vorpal) :blush:This tiny little module wouldn‘t be possible without the work of [all these amazing humans](thanks.md). Thanks.
## License
MIT © [Michael Kühnel](http://michael-kuehnel.de)