darekaze/canorous

A Free Modern app for listening & sharing awesome audio streams with friends

Listen & Share Awesome Audio Streams with Friends

What is Canorous?

Canorous (/kəˈnɔːrəs/, meaning pleasant sounding) is a free modern native app for Listening and Sharing awesome audio streams with friends.

It is made with Flutter 💖, following the incredible BLoC pattern (using the bloc library).

If you appreciate this app, support this project visibility by giving 👍/⭐

Features

• Search YT (with Invidious)
• Audio-only streaming
• Automatic cache management
• Custom playlists
• Recently played list
• Moment (post-sharing service)
• Used only Internet Permission
• Background playback (only in Android)

Upcoming...

• Better play control & playlist
• General Music Features (e.g. Shuffle)
• Notification Control
• Background playback (iOS)
• Import/Export Playlist

Building

Follow the Flutter Official Guide to install Flutter & Android Studio, together with the Flutter Plugin.

Ensure that the installation is successful by running:

$ flutter doctor

Then, clone the repository from GitHub:

$ git clone https://github.com/darekaze/canorous.git

Open the directory using a terminal:

$ cd canorous

Get the packages from pub:

$ flutter packages get

Build the apk package by running:

$ flutter build apk --flavor production -t lib/main.dart

or install the app in iOS by running (non-permanent method):

$ flutter run --release --flavor production -t lib/main.dart

Contributing

Our main goal is to make the app faster and easier to use. Read below to learn how you can take part in improving Canorous.

Code of Conduct

Canorous adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

Contribution Guide.

Read our contributing guide to learn about our development process, how to propose bugfixes and improvements.

Packages & Services used

• Invidious - Used in Searching YT video
• Youtube Extractor - Obtaining the audio link from YT, magically
• audioplayers - Audio player plugins for both Android & iOS
• Flutter bloc - For implementing the BLoC pattern with ease
• sembast - NoSQL persistent store database

Other dependencies

• fluro
• dio
• rxdart
• flutter_hooks
• cached_network_image
• shared_preferences
• flutter_local_notifications
• flutter_spinkit
• shimmer
• timeago
• share
• marquee

License

Canorous is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.