Lunar.Music.Web

This is a web app for Lunar Music project. User will be using this web portal to communicate with the Raspberry Pi.

Key Technologies

1. Gin Web Framework
2. Microsoft Azure
   1. Storage
   2. Azure Active Directory
3. RabbitMQ

Screenshots

How to use? (Localhost)

1. Install Golang on your local machine;

2. Clone the project to local;

3. Install necessary Golang packages;

4. (Optional) Start a local HTTP server such as http-server in the static directory;

   This step is optional because now the static files are served from my Azure Storage. So you can directly use mine. Otherwise, feel free to update all the links pointing to those static in the app\templates directory to your own URL.

5. Create a .env file in the app directory with the following content;

   AZURE_AD_CALLBACK_URL=
   AZURE_AD_CLIENT_ID=
   AZURE_AD_CLIENT_SECRET=
   RABBITMQ_ALLOWED_MICROSOFT_USER_ID=
   RABBITMQ_SERVER_CONNECTION_STRING=
   RABBITMQ_CHANNEL_NAME=
   SECURECOOKIE_HASH_KEY=
   SECURECOOKIE_BLOCK_KEY=
   

   The RabbitMQ part is optional because it is used only for communicating with my Raspberry Pi.

6. Build the go web project in the app directory;

7. Run the output exe.

Contributing

First and foremost, thank you! I appreciate that you want to contribute to this project which is my personal project. Your time is valuable, and your contributions mean a lot to me. You are welcomed to contribute to this project development and make it more awesome every day.

Don't hasitate to contact me, open issue, or even submit a PR if you are intrested to contribute to the project.

Together, we learn better.

License

This library is distributed under the GPL-3.0 License found in the LICENSE file.