Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 76 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,78 @@
# <img src="fastlane/metadata/android/en-US/images/Header.gif">

<p align="center">
<img src="https://img.shields.io/github/stars/raag-music/raag.svg" alt="stars" />
<img src="https://img.shields.io/github/forks/raag-music/raag.svg" alt="forks" />
</p>
<p align="center">
<img src="https://img.shields.io/github/issues/raag-music/raag.svg" alt="issues" />
<img src="https://img.shields.io/github/contributors/raag-music/raag.svg" alt="Contrinutors" />
<img src="https://img.shields.io/github/license/raag-music/raag.svg" alt="License" />
<img src="https://badgen.net/github/release/raag-music/raag" alt="Release" />
</p>

# Raag
<p>
<div align="center">

<table cellspacing="0" cellpadding="0">
<tr>
<td><a href="https://f-droid.org/en/packages/in.amfoss.raag"><img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
alt="Get it on F-Droid"
height="70"></a></td>
<td><img src="https://action-badges.now.sh/raag-music/raag" height ="35"></td>
<td><a href="https://www.buymeacoffee.com/ashwinr"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" height="35"></a></td>
<td>
<a href="https://f-droid.org/en/packages/in.amfoss.raag"><img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"alt="Get it on F-Droid"height="70">
</a>
</td>
<td>
<a href="https://f-droid.org/en/packages/in.amfoss.raag"><img src="https://github.com/raag-music/raag/actions/workflows/flutter.yml/badge.svg"alt="Get it on F-Droid"height="35">
</a>
</td>
<td>
<a href="https://www.buymeacoffee.com/ashwinr"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" height="35"></a>
</td>
</tr>
</table>
</div>
</p>

Open Source music player app made using [Flutter](https://flutter.dev/)
## Features
## Features 🧐️
* Download audio from YouTube with the highest possible bitrate
* Play on-device music files
* Dark and light themes
* In-app YouTube browser to search and download your favorite music quickly

## Screenshots
## Getting Started 🏃‍♂️️

- These instructions will get you a copy of the project up and be running on your local machine for development and testing purposes.

### Prerequisites ✍️

- [Android Studio](https://developer.android.com/studio), with a recent version of the Android SDK.
- [Flutter](https://flutter.dev/)
### Setting up your development environment 🏭️

1. Download and install Git.
2. Fork [Raag](https://github.com/raag-music/raag.git)
3. Clone your fork of the project locally. At the command line:

```
$ git clone https://github.com/YOUR-GITLAB-USERNAME/raag.git
```

4. Open your code favourite editor (VS Code, Android Studio etc)
5. Click on 'Open an Existing Project'
6. Browse to the directory where you cloned the repo and click OK
7. Let your code editor import the project
8. To install the dependencies run the following command in the terminal.

```
$ flutter pub get
```
9. Connect your Android emulator or your mobile device to your computer.
10. Build the application in your device by clicking **Run** <img src="https://www.iconsdb.com/icons/preview/green/play-xxl.png" alt="run" width="2%"/> button or run the following in terminal.
```
$ flutter run
```


## Screenshots 🤩️
<table>
<tr>
<td><img src="https://raw.githubusercontent.com/raag-music/raag/master/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png"></td>
Expand All @@ -37,4 +87,20 @@ Open Source music player app made using [Flutter](https://flutter.dev/)
</table>


Icon source: <a target="_blank" href="https://icons8.com/icons/set/musical-notes">Musical Notes icon</a> icon by <a target="_blank" href="https://icons8.com">Icons8</a>
## How to Contribute 🤔
To contribute to this project you can FORK & clone 🍴 the project as mentioned in *Setting up your development environment*, and make an issue on bug fixing or adding new features, and make a PR 😊.

## License 📄️
This project is licensed under the [GPL General Public License v2.0](https://github.com/BolisettySujith/raag/blob/master/LICENSE).


## Resouces 🎓

A few resources to get you started if this is your first Flutter project:

- [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab)
- [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook)
- Icon source: <a target="_blank" href="https://icons8.com/icons/set/musical-notes">Musical Notes icon</a> icon by <a target="_blank" href="https://icons8.com">Icons8</a>

For help getting started with Flutter, view the [online documentation](https://flutter.dev/docs), which offers tutorials,
samples, guidance on mobile development, and a full API reference.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 4 additions & 4 deletions pubspec.lock
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ packages:
name: async
url: "https://pub.dartlang.org"
source: hosted
version: "2.8.1"
version: "2.8.2"
audio_manager:
dependency: "direct main"
description:
Expand Down Expand Up @@ -63,7 +63,7 @@ packages:
name: characters
url: "https://pub.dartlang.org"
source: hosted
version: "1.1.0"
version: "1.2.0"
charcode:
dependency: transitive
description:
Expand Down Expand Up @@ -260,7 +260,7 @@ packages:
name: matcher
url: "https://pub.dartlang.org"
source: hosted
version: "0.12.10"
version: "0.12.11"
meta:
dependency: transitive
description:
Expand Down Expand Up @@ -496,7 +496,7 @@ packages:
name: test_api
url: "https://pub.dartlang.org"
source: hosted
version: "0.4.2"
version: "0.4.3"
typed_data:
dependency: transitive
description:
Expand Down