From their README


TwitchStreamer Workflow for Alfred


  • Search streams and watch via VLC or mpv or IINA (Streamlink (former Livestreamer) required)

  • keywords: tw, twtop, twgames, optional: twcover`

  • twtop: show top live streams (sorted by number of current viewers)

  • twgames: show top live games streamed (sorted by number of current viewers)

  • tw: search specific live channel/game

  • twcover: download/preload game icons for better user experience

  • browse philosophy: twtop or twgames for getting the most wanted streams on

  • search philosophy: tw star finds streamer like "starman" and "starcraft"-games streams


Check who is streaming on (category gaming) and watch your favorite stream via Streamlink on VLC or mpv or IINA (no lags anymore, thanks to buffering).

The main keyword is tw and the second word is the game or stream you want to watch (examples: tw voyboy or tw league of legends or also simply tw league). Alternative: Use keyword twtop to see the current TOP streams or twgames for the current TOP streamed games. Limit of streams is changable via specific workflow ($limit-variable).

With enter you can open the stream via Streamlink on VLC or mpv or IINA.

The streamer list is sorted by number of viewers descending. The quality of the stream is "high". If you want to change it to best (e.g.), feel free to open the existing "Terminal Command" (alfred, workflow-window) and modify the streamlink line.

Optional: If you deleted your game icons/covers folder (because many of them are outdated) you should use twcover to download all the top game covers. Otherwise tw or twtop will do it, but it takes more time and downloads less covers at the same time.

Screenshot: Entry point

Workflow Screenshot

Screenshot: Browsing TOP STREAMS

Workflow Screenshot

Screenshot: Browsing TOP GAMES

Workflow Screenshot

Screenshot: Searching STREAM (Channel or Game)

Workflow Screenshot

Screenshot: Downloading GAME COVERS/POSTERS

Workflow Screenshot Workflow Screenshot

Screenshot: Watching STREAM

Workflow Screenshot


Required: Alfred, Streamlink and VLC or mpv or IINA.

Required since macOS Monterey: Open a Terminal, install Homebrew and run brew install php

Made/Tested in/with OSX 10.15.7 and macOS 12.4, Streamlink 2.4.0, VLC 3.0.16, PHP 7.3.11, AppleScript >2.5, Twitch API (Oct. 2021)

Supports OneUpdater/AlleyOop/Monkey Patch (workflow updater).



  • it takes a lil time between entries because of the Twitch API


  • Adding more information for "twgames": number of cannels and viewer (via get streams and game_-_id/user_id)

  • Adding more information for "tw *": viewers (via get streams and broadcaster-id)


If you have found bugs/issues use the issues tracker or if you just want to say "hello" in addition so send me an email: [email protected]



GNU General Public License version 3



  • Added viewer counts to TOP games and searched streams
  • Added search for game IDs (via twgames)
  • Renamed some API functions


  • Small update to make it work under Alfred 5


  • Small update to make it work under Alfred 4


  • Updated entire Twitch API to latest (incl. new oauth).
  • Changed livestreamer to streamlink.
  • Added VLC, MVP and IINA player support.
  • Updated game covers.


  • Changed streaming quality to Best (from High), because many streams will not work with High as default quality.
  • Added new game covers.


  • Updated jdfwarriors workflows.php for Alfred 3 support (fixed warnings), updated github project link to a generic one.


  • Updated OneUpdater (thx@ vitorgalvao), replaced NSAppleScript by a normal RunScript(JS) that handles the latest installed Alfred (no matter if we switch to Alfred 4..5..6 in future), fixed connection issues by changing file_put_contents to curl and extending url_get_contents().


  • Added OneUpdater (forum post) that allows you to update the workflow out of the box (it checks for updates automatically every 15 days and downloads/opens new versions). Changed the usage of Terminal to Run Script (no opened terminal any longer during watching stream). Thx@ vitorgalvao.


  • Replaced file_get_contents() by an own created url_get_contents() that is using curl. It seems file_get_contents(): https:// wrapper is disabled in the server configuration by allow_url_fopen=0 on the new macOS Sierra.


  • Livestreamer has not been updated so far regarding Twitch API changes. => Added a workaround to the workflow without requiring a livestreamer update to make it work.


  • Regarding twitch API changes, added client id to every request.
  • Regarding twitch API changes, changed string encoding of images.
  • Hence all game covers are renamed or replaced.


  • Minor update.
  • Added support for mpv playback (thx@ Jonathan Dahan)


  • Changed vjpg-branch to master.
  • Modified terminal command: Quits Terminal automatically.
  • Deleted twgame.
  • Added twgames (top streamed games by viewers).
  • Added twbygame, similar to the old twgame.


  • Modified terminal command: Terminal must no longer stay open (thx@ mclowe-directnic).
  • Added some covers.
  • Fixed updater (json).


  • Switched cover-format from png to jpg (due to issue#1).
  • Cleaned up code.

1.5.0 - 1.5.2

  • Big Update.
  • Added twgame.
  • Added twcover (downloads and converts game covers).
  • Fixed sort order bug, thanks to tyler and andrew.
  • Added some covers.


  • Big Update (reworked the whole code).
  • Added twtop.
  • tw searches more efficient and games as well as streams.


  • First real release without webserver.
  • Added AlleyOop/Monkey Patch support (workflow updater).
  • Downgraded Workflows from 0.32 to 0.3 due to a sort-bug.


  • First release with all functions. Based on stream-parsing on webserver.