A minimal and beautiful lyrics app for macOS
Switch branches/tags
Nothing to show
Clone or download
AnaghSharma Updated CONTRIBUTING.md
Add a section for State Machine
Latest commit 9fd4901 Jul 8, 2018

README.md

Carol

Carol is a minimal and beautiful lyrics app for macOS



Features

  • Supports Apple Music and Spotify
  • Minimal design with support for Album artworks
  • Fetches lyrics from Musixmatch - world's largest catalog of lyrics
  • Stays in the menu bar of macOS for quick access
  • Provides options to change text size and open lyrics in browser
  • Light in size

How to use

Requirements

macOS 10.10 (OS X Yosemite) and above

Download

Download the latest release from here.

Install

  1. Double click the Carol-<version>.pkg file.
  2. Follow the onscreen instructions to install the app.

Note - If you security settings do not allow to install apps from third party developers, go to Preferences -> Security & Privacy -> General Tab. You will be shown an Open Anyway button if you had tried to install the app before. Use this and you will be good to go.

Launch

Launch the app from Applications folder. It will open in your menu bar. Enjoy.

Contributing

Thanks for showing interest in this project and its development. If you think this project can be improved, you are welcome to contribute. Please go through the CONTRIBUTING.md for contributing instructions.

Note

  1. The app uses the free version of Musixmatch API which returns only 30% of a song's lyrics.
  2. The API calls are limited to 2000 per day.

Contact

Follow me on Twitter

Disclaimer

This project is for learning purpose only. If you want to learn macOS development and Xamarin technologies, feel free to use this project. Please do not sell/re-sell the project or its content as it uses the free plan of Musixmatch API which prohibits it for any commercial use. Use it at your own risk.