auralous / auralous Goto Github PK

Play & listen to music in sync with friends around the world

License: GNU Affero General Public License v3.0

JavaScript 1.87% CSS 0.14% TypeScript 90.62% Starlark 0.13% Java 3.33% Objective-C 0.50% Ruby 0.34% HTML 0.22% C++ 1.69% Objective-C++ 1.00% Shell 0.10% CMake 0.06%

music youtube spotify real-time react collaboration apple-music

auralous's Introduction

Music is always better when we listen together

Auralous is a free project that lets you play & listen to music in sync with friends in group sessions.

Auralous currently supports streaming music on YouTube and Spotify. We hope to add support for Apple Music soon.

Website: auralous.com

Structure

Codebase	Description
web	React Native Web app
mobile	React Native app for Android and iOS
app	The shared main app
api	GraphQL API / URQL code, hooks, and exchanges

Workflows

package.json contains the several scripts in the workspace root.

`yarn dev`

Start the file watcher to build types and codegen for the project for uses in both web and mobile. You only need run it for two purposes:

type checking during development
run codegen when schema changes

`yarn lint`

Run yarn lint to check for errors in source code using eslint and apply formatting with prettier. You can also run yarn lint --fix to let eslint fixed the errors automatically.

Contribution

See CONTRIBUTING.md.

Acknowledgements

This project is not possible without:

All the OSS libraries and their maintainers
Odesli API for cross-playing functionality
last but not least... you

auralous's People

Contributors

Stargazers

Watchers

Forkers

sharp-team tantruong-amblique some-forks sidekicktec virtuoseit vinayak1857

auralous's Issues

Persistent chat

Is your feature request related to a problem? Please describe.

Room chat is currently not persistent.

Describe the solution you'd like

Chat should be persistent.

Describe alternatives you've considered

Additional context

We need to consider aspects such as whether a message can be deleted, how to fight abuses, moderation, etc...

Bug Report/Feature Request/Suggestion

Thank you for using Auralous.

If you encounter a bug or want an improvement, reporting to us so that we can resolve it as quick as possible.

If you are not a developer, report to one of the below:

Google Form: https://forms.gle/HdcjxPVpxnanu9Xg6
FB Messenger: https://m.me/auralous

If you are a developer, report using the Issues page

Apple Music support

We need to add support for Apple Music.

Investigate Apple Music client
Implement in API Server

Rename project

I recently found out that this project name was conflicting with stereo.com (even the logo looks similar...) We need to think of a new name.

Question : backend servers

Hey @hoangvvo,

Thanks for open sourcing this project. I'm impressed by the benchmark of benzene but cannot really find a complete setup with a backend codebase (like you did for you nexjs-mongodb-app).

Do you plan to open source also the servers : websocket and API ?
If not do you mind just sharing what server you used to play well with benzene-ws-client ? And what do you use server side for the graphql part (apollo-server or something else) ?

I have a project where I use typeORM + type-graphql + apollo-server + postgresql and was wondering if it could connect easily with your urql + benzene frontend setup.

Spotify Connect (Listen on other devices)

Is your feature request related to a problem? Please describe.
Spotify Connect allows listening to music on different devices and it is a core feature in Spotify apps.

Describe the solution you'd like
Add Spotify Connect support. /v1/me/player/play can be used.

Additional context
This also allows using Stereo on mobile devices (which is currently not possible due to limitation of Spotify SDK)

Moderation

We need to add moderation features:

Ban or kick a user
Assign moderators

development: how to authenticate

You cannot sign into Auralous API using the development app.

@auralous/web

To authenticate, login on https://app.auralous.com/ and copy the access_token local storage key over to the development web app.

localStorage.getItem('access_token');

Reload the page and you should be logged in.

@auralous/mobile

Get the access token from app.auralous.com as above.

Visit the url auralous://sign-in?access_token=*** on mobile to sign in.