Skip to main content

Display lyrics on your touchbar with BTT

Project description


Synced Lyric on TouchBar


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!

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.6.8.tar.gz (7.1 kB view hashes)

Uploaded source

Built Distribution

touchbar_lyric-0.6.8-py3-none-any.whl (8.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page