Skip to main content

Display lyrics on your touchbar with BTT

Project description


Synced Lyric on TouchBar


:warning: I no longer have a macbook with TouchBar, so I won't be able to update this project as often.

Codacy Badge Build Status Codacy Badge PyPI version

Show synced lyric in the touch-bar with BetterTouchTool and NetEase/QQ Music APIs. Based on the idea of Kashi.

Preview Preview


  • Synced lyrics from QQ Music and NetEase Music APIs;
  • Support Spotify (Recommended) & Music (Only songs in your playlists);
  • Support for English/Spanish/Chinese(Simplified/Traditional)/Japanese and more;


If you are not familiar with command line, python ecosystem or having problems understanding this tutorial, find a friend to help you. Issues/DMs are not actively monitored for this project.

1. Installation

pip3 install touchbar_lyric --upgrade

2. Configuration in BetterTouchTool

Same as Kashi:

  1. Copy&paste the content in lyric.json in Meun Bar > Touch Bar;
  2. Change the python path $PYTHONPATH to your own python path in the script area;
$PYTHONPATH -m touchbar_lyric --app Music

or use Spotify(default)

$PYTHONPATH -m touchbar_lyric --app Spotify

Show Traditional Chinese lyrics

$PYTHONPATH -m touchbar_lyric --app Spotify --traditional

Be careful with typing double hyphens in BTT. It automatically change it to an em slash. Use copy & paste instead!


  1. Inspired by Kashi by Jim Ho.
  2. Supported by wonderful projects like qq-music-api by Rain120 and spotifylyrics by SimonIT.


This project is not affiliated with Apple, Spotify, QQ Music, NetEase Music, BetterTouchTool or any other third party. This project is not intended to violate any terms of service of the aforementioned parties. This project is for educational purposes only.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

touchbar_lyric-0.8.1.tar.gz (10.6 kB view hashes)

Uploaded source

Built Distribution

touchbar_lyric-0.8.1-py3-none-any.whl (11.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page