https://github.com/AnaghSharma/Carol-Xamarin

A minimal and beautiful lyrics app for macOS built with Xamarin and C#
https://github.com/AnaghSharma/Carol-Xamarin

app itunes lyrics mac macos macos-app macos-menubar macosx music musixmatch popover spotify xamarin xamarin-mac

Last synced: about 2 months ago
JSON representation

A minimal and beautiful lyrics app for macOS built with Xamarin and C#

• Host: GitHub
• URL: https://github.com/AnaghSharma/Carol-Xamarin
• Owner: AnaghSharma
• License: gpl-3.0
• Created: 2017-07-13T17:01:09.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2022-12-07T19:30:04.000Z (almost 2 years ago)
• Last Synced: 2024-04-15T04:29:37.735Z (5 months ago)
• Topics: app, itunes, lyrics, mac, macos, macos-app, macos-menubar, macosx, music, musixmatch, popover, spotify, xamarin, xamarin-mac
• Language: C#
• Homepage:
• Size: 13.9 MB
• Stars: 104
• Watchers: 8
• Forks: 5
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        


Carol

Carol is a minimal and beautiful lyrics app for macOS









Buy the latest version for macOS Catalina




## Features

* Supports Apple Music and Spotify

* Minimal design with support for Album artworks

* Fetches lyrics from [Musixmatch](https://www.musixmatch.com) - 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.](https://github.com/AnaghSharma/Carol/releases)

#### Install

1. Double click the `Carol-.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](https://github.com/AnaghSharma/Carol/blob/master/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](https://twitter.com/AnaghSharma)

## 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.