Skip to main content

`Akttym` is a simple script placing heart/like/whatever-they-call-it on currently playing track on Spotify, which combined with global keyboard shortcut allows for complete headless setup.

Project description

akttym - AKA Add current track to your music library

Have you ever caught yourself liking tracks on Spotify obsessively to take advantage of their sweet machine learning recommendations? Yeah, me too. But alt-tabbing into the app every 3 minutes sucks. With akttym you can stay focused on your work and place like on your favorite music with a keyboard shortcut.

Akttym is a simple script placing heart/like/whatever-they-call-it on currently playing track on Spotify, which combined with global keyboard shortcut allows for complete headless setup.

And yes, there is a typo in the name.

Getting Started

This is a Python3 script, so it works with most Linux distributions and with macOS. I haven't tested it out on Windows, if there's a demand for it, please let me know!

Disclaimer: It only works with on-line playback.


  1. To install akttym, just simply pip install it from PyPI:
python3 -m pip install akttym
  1. It comes with empty config.yaml. In order to fill it up with your user data, run akttym for the first time, and it will tell you where the config file is located:
python3 -m akttym
WARNING:root:Config is invalid. username key is empty or does not exist.
                   Config file can be found at: /Users/evemorgen/Desktop/akttym/akttym/config.yaml
  1. Create a Spotify app at and copy client_id and client_secret into config file. Don't forget to add your username as well.
  2. Add http://localhost:1911/ redirect uri your new spotify app [Edit Settings -> Redirect URIs -> ADD].
  3. Run the script once again. This time it should open a website in your browser. Accept Spotify privacy stuff, after agreeing to sell your soul, you're good to go.
  4. It just works! (hopefully).
python3 -m akttym
INFO:root:added Life On Mars? - 2015 Remastered Version to evemorgen's library

Binding akttym to keyboard shortcut


  1. Search for Automator app and open it.
  2. Create new service [Service -> Choose]
  3. Drag and drop run shell script to workflow window
  4. Select no input in Service receives dropdown and fill in command textbox with python3 -m akttym
  5. Save created service (Cmd+S or [File -> Save]) with name akttym
  6. Close Automator and navigate to keyboard shortcuts settings [System preferences -> Keyboard -> Shortcuts -> Services]. At the very bottom of services list you should see newly created service. Double click on it and pick any key combination you like (be aware that you could override any of existing shortcuts)
  7. Test it out? Profit?

ElementaryOS (Gnome)

  1. Enter keyboard settings [System Settings -> Keyboard -> Shortcuts -> custom]
  2. Click on + button and add python3 -m akttym command
  3. it works?


Everytime I run it, it opens a new browser tab

Try to chmod 766 /path/to/script/dir. Akttym needs write permission in directory where it's located

Browser tab opens with message INVALID_CLIENT: Invalid redirect URI

Make sure the right redirect uri (http://localhost:8080/) is added to the Spotify app. After clicking Add button you still have to click Save button at the very bottom of the page.



This project is licensed under the MIT License - see the file for details

Project details

Download files

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

Files for akttym, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size akttym-1.0.2.tar.gz (4.4 kB) File type Source Python version None Upload date Hashes View

Supported by

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