Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/Angel-Studio/SoundTap

SoundTap is an Android app that enhances your music listening experience by allowing you to control playback using your device's volume buttons. Skip tracks, pause, and resume with ease. Built with Kotlin and Jetpack Compose.
https://github.com/Angel-Studio/SoundTap

android android-application customization experimental jetpack-compose kotlin kotlin-android material-3 material-you media-control

Last synced: about 1 month ago
JSON representation

SoundTap is an Android app that enhances your music listening experience by allowing you to control playback using your device's volume buttons. Skip tracks, pause, and resume with ease. Built with Kotlin and Jetpack Compose.

Lists

README

        

![Cover Image](/RESOURCES/Cover-1024x200.png)

# SoundTap - Android Volume Media Controller App

SoundTap is a simple and intuitive Android app that allows users to control their media playback
using the volume buttons on their device. It enhances the functionality of the volume buttons,
enabling users to skip tracks, pause, and resume music playback with ease.

## ⬇️ Install App

[![Play Store](https://img.shields.io/badge/Google_Play-414141?style=for-the-badge&logo=google-play&logoColor=white)](https://play.google.com/store/apps/details?id=fr.angel.soundtap)
[![GitHub](https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white)](https://github.com/Angel-Studio/SoundTap/releases)


Light
   
Dark
   
Dark
   
Dark

## ✨ Features

- [x] **Volume Button Controls**: Skip tracks forward or backward by long-pressing the volume up or
down buttons.
- [x] **Media Playback Pause/Resume**: Pause and resume media playback by long-pressing both buttons
simultaneously.
- [x] **Working Mode**: Choose when the actions should be available (when screen is on, off, or
always).
- [ ] **Customizable Controls**: Customize which actions (skip forward, skip backward, pause,
resume) are performed by long-pressing or double-pressing the volume buttons.
- [x] **Widget**: Includes a widget for quick access to media playback controls directly from the
home screen.
- [x] **Supported Players**: SoundTap works with popular media players like Spotify, YouTube Music,
and more.
- [x] **Auto-Play**: Automatically start media playback when the volume buttons are long-pressed or
when a headset is connected.
- [x] **Customizable Haptics**: Adjust the haptic feedback intensity to suit your preferences.
- [x] **Customizable Delays**: Adjust the long-press delay to fit your preferred interaction speed.
- [ ] **Localization**: Available in multiple languages for a global audience.
- [x] **Dark Mode**: Supports both light and dark themes for a comfortable viewing experience.
- [x] **Accessibility**: Designed with accessibility in mind to ensure a seamless user experience
for all users.
- [x] **Privacy**: Respects user privacy by collecting only necessary data for app functionality.
- [x] **Offline Support**: Works without an internet connection for uninterrupted media playback.
- [x] **Lightweight**: Lightweight app with minimal system resource usage for optimal performance.
- [x] **No Ads**: Completely ad-free experience for users to enjoy media playback without
interruptions.
- [x] **Free & Open Source**: Free to use and open source for transparency and community
contributions.
- [x] **Onboarding Screen**: Introduce users to SoundTap's features and functionality with an
interactive onboarding screen.
- [x] **Material You Theming**: Adapts to the system-wide theme on Android 12 devices for a
consistent user experience.
- [x] **Analytics**: Collects usage data to improve the app and provide a better user experience.

## 🌏 Languages

- [x] **en-US**
- [ ] **fr-FR**
- [ ] **es-ES**
- [ ] **de-DE**
- More languages coming soon!

## 🚀 Getting Started

### Installation

Clone the repository:

```bash
git clone https://github.com/Angel-Studio/SoundTap.git
```

Open the project in Android Studio and build the APK file to install on your Android device.

### :gear: Usage

1. Launch the SoundTap app on your Android device.
2. Follow the on-screen instructions to grant necessary permissions.
3. Use the volume buttons on your device to control media playback:
- Long-press volume up/down to skip tracks.
- Long-press both volume buttons to pause/resume playback.
4. Customize controls as desired in the app settings.

## :hammer_and_wrench: Tech Stack

- :dart: **Language**: Kotlin
- :art: **UI Toolkit**: Jetpack Compose
- :artificial_satellite: **Theming**: Material You Theming System
- :bar_chart: **Analytics**: Firebase

## 🏗️ Contributing

Contributions are welcome! If you have any feature requests, bug reports, or suggestions, please
open an issue or submit a pull request.