VolumeValet-Server

VolumeValet is a convenient Android app for controlling your PC's volume from your phone over the local network. This repo is for the VolumeValet-Server that needs to run on your PC.

Check out the VolumeValet App
Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Usage
3. Building Locally/a>
   • Steps
4. Roadmap
5. Contributing
6. License
7. Contact

About The Project

Whether you're watching a movie, playing a game, or just listening to music, VolumeValet makes it easy to adjust the volume without adjust the volume of your PC without having to reach for the physical controls. Try VolumeValet today and experience the convenience of controlling your PC's volume from your Android phone!

Features

• Ability to adjust the volume of your PC from your Android phone over the local network.
• Quick mute and unmute functionality.
• Control media playback (pause, play, next, previous).
• Easily connect with PC using QR code.
• Add-free UI.

(back to top)

Built With

(back to top)

Usage

1. Download the precompiled app from here or build the app locally.
2. Start the server on PC.
3. Launch the Android app. See VolumeValet for details.
4. Scan the QR or enter the address and port manually.
5. Press the Connect button.
6. You are connected!

(back to top)

Building Locally

Pre-requesite

Before anything, be sure to have a working python setup. If not installed, go to BeginnersGuide/Download - Python.

Steps

1. Clone the repo

   $ git clone https://github.com/kshitij-ra/VolumeValet-Server.git

2. Extract the file and cd to the repo folder.
3. To install dependencies, run

   $ pip3 install -r requirements.txt

4. Then run the following in a terminal

   $ python desk.py

(back to top)

Roadmap

• Option to scan QR to connect.
• Adopt Material3 Design.
• Control playback (pause, play, next, previous).
• Integration with Android's accessibility features for users with visual or motor impairments.
• Option to adjust individual channel volumes for systems with multiple speakers or headphones.
• Integration with Android's voice assistant, allowing for hands-free volume control.
• Compatibility for other operating systems.
• Option to control volume using the volume keys of android device.
• Create webapp.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Kshitij Radotra - @kradotra - [email protected]

Project Link: https://github.com/kshitij-ra/VolumeValet-Server

(back to top)