https://github.com/AnaghSharma/Carol

Carol is a minimal and beautiful lyrics app for macOS built with SwiftUI
https://github.com/AnaghSharma/Carol

lyrics macos musixmatch swift swiftui swiftui-example

Last synced: about 1 month ago
JSON representation

Carol is a minimal and beautiful lyrics app for macOS built with SwiftUI

• Host: GitHub
• URL: https://github.com/AnaghSharma/Carol
• Owner: AnaghSharma
• License: gpl-3.0
• Created: 2020-11-25T15:10:31.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2021-01-02T17:22:45.000Z (almost 4 years ago)
• Last Synced: 2024-11-08T12:23:05.555Z (about 1 month ago)
• Topics: lyrics, macos, musixmatch, swift, swiftui, swiftui-example
• Language: Swift
• Homepage:
• Size: 3.4 MB
• Stars: 111
• Watchers: 2
• Forks: 5
• Open Issues: 2
• 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

• open-source-mac-os-apps - Carol - A minimal and beautiful lyrics app that stays in the menu bar of macOS. ![c_sharp_icon] (Applications / Music)
• Mac-Menubar-Megalist - Carol
• open-source-mac-os-apps - Carol - A minimal and beautiful lyrics app that stays in the menu bar of macOS. ![c_sharp_icon] (Applications / Music)

README

        



Carol

Carol is a minimal and beautiful lyrics app for macOS built with SwiftUI









## Features

* Automatically identifies the currently playing song and shows its lyrics.

* One-touch access to lyrics straight from the menu bar.

* Supports both Apple Music and Spotify.

* Minimal design with support for Album artworks.

* Adapts to system's light/dark theme.

* Light in size.

## How to use

#### Requirements

macOS 10.15 (Catalina) and above.

#### Download

[Download the latest release from here.](https://github.com/AnaghSharma/Carol/releases)

#### Install

Unzip the `Carol.zip` file and copy `Carol` to your Applications folder.

#### Launch

Launch the app from the Applications folder. It will appear in your menu bar. Provide required permissions on first launch and Enjoy.




## Donate

Buy me a coffee to support the development of this project. SwiftUI has much more to offer that can be implemented in this project.



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

## 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 SwiftUI technologies, feel free to use this project. Please do not sell/re-sell the project or its content as the lyrics are copyrighted material and are properties of their respective owners.