Skip to content

Repository files navigation

Processional

An Android music player built for one job: at a wedding (or any ceremony), when the operator stops the music it fades smoothly to silence instead of cutting out abruptly — and it fades back in when you press play.

Features

  • Add songs from your phone; the playlist is remembered between launches, so you can set everything up the day before.
  • ▶ PLAY — fades the selected song up from silence.
  • ⏬ FADE OUT — fades down to silence, then pauses. Press PLAY again to fade back in from where it left off.
  • Fade length adjustable from 1–15 seconds (default 5).
  • ■ Stop (instant) — a hard stop for emergencies.
  • Perceptually even (decibel-based) fade curve, so it sounds natural.
  • Keeps the screen awake while open; fades out gracefully if a call comes in.

Install the prebuilt app

A ready-to-install build is in releases/Processional.apk.

  1. Copy the APK to your Android phone (email it to yourself, Google Drive, USB, etc.).
  2. Tap the file. Android will ask permission to install from an unknown source — allow it for the app you opened it with.
  3. Open Processional, add your songs, and do a rehearsal with the volume up.

Runs on Android 7.0 (API 24) and newer. The build is debug-signed, which is fine for personal use; it just won't auto-update or go on the Play Store as-is.

Build it yourself

Requires JDK 17+ and the Android SDK (platform 34, build-tools 34.0.0). Point the build at your SDK by creating a local.properties file:

sdk.dir=/path/to/your/Android/sdk

Then build the debug APK with the included Gradle wrapper:

./gradlew assembleDebug

The APK lands in app/build/outputs/apk/debug/app-debug.apk.

To install directly to a USB-connected phone (with USB debugging enabled):

./gradlew installDebug

About

An app for fading music

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages