https://github.com/goronfreeman/alfred-genius

A Genius workflow for Alfred 3
https://github.com/goronfreeman/alfred-genius

alfred alfred-workflow genius

Last synced: 8 months ago
JSON representation

A Genius workflow for Alfred 3

• Host: GitHub
• URL: https://github.com/goronfreeman/alfred-genius
• Owner: goronfreeman
• Created: 2016-04-07T17:41:41.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2017-11-17T03:34:13.000Z (over 8 years ago)
• Last Synced: 2025-10-09T12:05:01.620Z (8 months ago)
• Topics: alfred, alfred-workflow, genius
• Language: Ruby
• Homepage:
• Size: 141 KB
• Stars: 11
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# alfred-genius

An [Alfred 3](https://www.alfredapp.com/) workflow for searching song lyrics on [Genius](https://genius.com/).

![alfred-genius](https://i.imgur.com/FDacgV8.png)

## Installation

[Download](https://github.com/goronfreeman/alfred-genius/releases/latest) the latest `Genius.alfredworkflow` file and double click it to install.

## Setup

After installing alfred-genius, type `genius`, then attempt to search for a song. You will see a message saying `Genius is not set up yet!` Press `Enter`, and you will be taken to the [Genius API clients page](https://genius.com/api-clients/new). If you do not have a Genius account, you will have to create one first. Create a new API client with the following information (or whatever you want):

| New API Client    |                                                                            |

| ----------------- | -------------------------------------------------------------------------- |

| `APP NAME`        | alfred-genius                                                              |

| `ICON URL`        | http://images.rapgenius.com/f2cb660689994b2564b2d493759c02a7.114x114x1.png |

| `APP WEBSITE URL` | https://github.com/goronfreeman/alfred-genius                              |

| `REDIRECT URI`    | `(empty)`                                                                  |

Click `Save`. On the next page under `CLIENT ACCESS TOKEN`, click `Generate Access Token`, then copy the token to your clipboard. Finally, open Alfred and type `gsetup`. Paste in the access token you just copied and press `Enter`. You should see a notification saying `Genius is now ready!` You can now type `genius` to search for any song you want.

## Usage

Simply type `genius` followed by a song name. You will see a list of songs, along with the artist name and album cover. Press `Enter` to open the song page on Genius, or press `Shift` to view the page in a quicklook window.

You can also select a result and hold `cmd`, then press `Enter` to view the artist page on Genius, or hold `alt`, then press `Enter` to search for the song on Google. If you want to copy the song URL, highlight a result, then press `cmd + c`.

## Credits

alfred-genius uses these libraries:

* [alfred-workflow-ruby](https://github.com/joetannenbaum/alfred-workflow-ruby) by [Joe Tannenbaum](https://github.com/joetannenbaum)

* [genius](https://github.com/timrogers/genius) by [Tim Rogers](https://github.com/timrogers)