Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mischah/itunes-remote

:notes: Control iTunes via CLI
https://github.com/mischah/itunes-remote

Last synced: 7 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: 2025-01-09T15:19:14.472Z (10 days ago)
Language: JavaScript
Homepage:
Size: 5.38 MB
Stars: 428
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: help

  Commands:

    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)