An Alfred workflow for quickly and easily playing music in iTunes
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
actions Change "unknown type" log to read "unsupported type" Jun 9, 2018
filters Revert "Filter tracks by media kind rather than kind" Jun 13, 2018
resources Revert "Filter tracks by media kind rather than kind" Jun 13, 2018
.editorconfig
.gitignore Add .virtualenv to gitignore Jun 14, 2016
.python-version Explicitly declare minimum required Python version Aug 8, 2016
LICENSE.txt
Play Song (Alfred 2).alfredworkflow Prepare v3.4.0 release May 28, 2016
Play Song (Alfred 3).alfredworkflow Prepare v5.0.0 release Jun 23, 2018
README.md
icon.png Reduce size of main workflow icon Aug 15, 2016
packager.json Remove alfred_version option Jun 17, 2016
requirements.txt Upgrade alfred-workflow-packager to 1.2.0 May 13, 2018
screenshot.png Update screenshot to use Alfred 3 theme Jun 12, 2016

README.md

Play Song

Copyright 2013-2018 Caleb Evans
Released under the MIT license

Play Song is an Alfred workflow designed to make playing music in iTunes extremely quick and convenient.

The workflow will be solely supporting Alfred 3 going forward, but the latest Alfred 2-compatible release (v3.3.1) will remain available here for your convenience.

Play Song in action

Usage

Play Song includes a number of keyword filters which allow you to search for and play songs in your iTunes library. For example:

Playing a song

playsong hey jude

Playing a song in a particular album

playsongin abbey road

Playing a song by a particular artist

playsongby beatles

Playing an album

playalbum pet sounds

Playing an album by a particular artist

playalbumby beach boys

Playing an artist

playartist killers

Playing a genre

playgenre alternative

Playing a playlist

playplaylist favorites

Queueing songs

For any of the above filters, choosing a result with the cmd key held down will queue the result (as opposed to playing it immediately). This allows you to queue up multiple songs before playing them.

To play the songs you've queued, use the playqueue keyword. To clear the queue of all songs, use the clearqueue keyword.

Note: At this time, Play Song does not support queueing for Apple Music playlists.

Searching songs on Google

For any of the above filters, choosing a result with the ctrl key held down will search the result on Google.

Clearing the cache

Play Song stores a local cache containing album artwork (from displayed results), as well as the compiled workflow configuration. If you experience any issues with Play Song, you can clear this cache via the clearcache keyword.

A note about play order

Play Song always respects the current shuffle mode within iTunes. For example, if shuffle is enabled, playing an album via Play Song will play the songs of the album in shuffled order. Therefore, if you desire Play Song to respect album order, simply disable shuffle within iTunes.

Playing a song directly (the Play Song v1 behavior)

If you are a longtime Play Song user who prefers the v1 behavior for playing songs (where music continues playing after the song finishes), you can do so via the shift modifier. Note that this only works for the playsong filter.

Support

If you have a bug to report or a feature to request, please submit an issue on GitHub.

Credits

Special thanks to Asger Drewsen for his invaluable feedback and code contributions.