ANDROID PLAYER AND MEDIA CENTRE

Perun Player Music, video and sound under your control.

Perun Player is a native, modular Android application combining local music, a media library, queues, playlists, favourites, local and network video, and a custom audio-processing system.

Android Media3 Custom PCM16 DSP Local library Local and network video
What already works What comes next User guide
Status: working Android development build
PERUN Media3 • HiFi

Northern Lights

Perun Audio Session

◀ ▶ ▶

WHAT PERUN IS

Not another basic player wearing a different skin

Perun is being built as one coherent media environment.

01

Personal library

Local music and video remain on the device.

02

Custom audio path

Media3, PCM16 and Perun's own audio processing system.

03

Modular architecture

Independent modules connected through one interface.

CURRENT BUILD

What Perun already includes

Below is the real scope of the current development build.

WORKING

Music playback

Full music playback controls, cover artwork and track information.

WORKING

Music library

Browse local tracks, albums and artists.

WORKING

Playback queue

A dedicated playback queue with retained context.

WORKING

Playlists and favourites

Dedicated playlist and favourites modules.

WORKING

Android Media3

Main playback engine with forced PCM16 output.

WORKING

AMP compatibility engine

Android MediaPlayer compatibility engine.

WORKING

Media3 equaliser

Equalisation integrated into the Media3 path.

WORKING

Bass processing

Custom low-frequency processing.

WORKING

Stereo widening

Adjustable stereo-space processing.

WORKING

Reverb

Adjustable room and hall reverb presets.

WORKING

HiFi mode

Clean playback with additional DSP effects bypassed.

WORKING

Local video

Video stored locally on the phone.

WORKING

Network video

Search and open network media inside Perun.

WORKING

Personalisation

Colour themes, custom backgrounds and interface styles.

WORKING

Breathing cover artwork

Optional animated cover-art effect.

PCM16 DSP

AUDIO ENGINE

Audio is part of the product, not an afterthought

In Media3 mode, PCM16 audio passes through Perun's own processor chain.

  • Forced PCM16 audio path.
  • Independent Media3 and AMP settings.
  • Bass and stereo processed directly on the signal.
  • Room and hall reverb.
  • HiFi mode bypassing additional effects.
EQ

Equaliser

Band control with retained settings.

B

Bass

Custom low-frequency processing.

LR

Stereo widening

Adjustable stereo-space expansion.

RV

Reverb

Rooms and halls in multiple sizes.

VIDEO

Local files and network media

Perun includes separate local-video and network-video modules.

YouTube Dailymotion Odysee Rumble RuTube Local files
Search or paste a video address
Local video
Network video
YouTube
Download queue

INTEGRATION AND ROADMAP

What Perun will include next

Planned items are separated from working features.

NEXT STEP

Video link to downloader

Shared and currently opened video links will be sent directly to the download queue.

INTEGRATION

Downloader

A dedicated download queue with quality, format and destination settings.

INTEGRATION

Media converter

Queued FFmpeg conversion of downloaded and local media.

TUNING

Limiter and signal protection

Further tuning of bass limits, headroom and clipping protection.

PLANNED

Loudness normalisation

Consistent perceived loudness across different media.

PLANNED

Internet radio

Search, save and play internet radio stations.

PLANNED

Timer, alarm and automation

Timed stop, scheduled start and playback-session restoration.

LATER

Additional platforms

Desktop and later iOS versions may follow Android.

TECHNOLOGY

A native application, not a website trapped inside a frame

Perun is developed natively in Kotlin with a modular Android architecture.

Platform
Android
Language
Kotlin
Main engine
Android Media3
Compatibility engine
Android MediaPlayer
DSP path
PCM16
Conversion
FFmpeg
User data
Stored locally on the device
Status
Active development
Perun Player user guide Click to open the complete application guide

APPLICATION SCREENS

Perun, screen by screen

These images are temporary slots for final application screenshots.

PLACEHOLDER Perun Player main playback screen
Main player screen Cover artwork, track information and playback controls.
PLACEHOLDER Perun Player music library
Music library Local tracks, albums and artists.
PLACEHOLDER Perun Player playback queue
Playback queue Track list and playback-order management.
PLACEHOLDER Perun Player audio settings
Audio engine and effects Media3, HiFi, equalisation and audio effects.
PLACEHOLDER Perun Player local and network video
Local and network video Local video, network search and direct address opening.
PLACEHOLDER Perun Player interface settings
Interface and personalisation Themes, colours and interface effects.
Final screenshots should show real application screens without private data.

USER GUIDE

How to use Perun Player

This guide covers the current application build.

01

Grant access

Allow access to media stored on the device.

02

Open the library

Browse tracks, albums and artists.

03

Add to the queue

Start playback or add tracks to the queue.

04

Tune the sound

Select an engine and configure the sound.

First launch

Music and video permissions
SCREENSHOT PLACEHOLDER Music and video permissions
Music and video permissions A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  1. Launch Perun Player.
  2. Allow media access when Android requests it.
  3. Open the Music or Video module.
  4. Reopen the module if the library is initially empty.
If access was previously denied, open Android Settings → Apps → Perun Player → Permissions.
Application navigation
SCREENSHOT PLACEHOLDER Application navigation
Application navigation A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

The navigation bar provides access to the main areas.

Queue
Tracks selected for the current playback session.
Music
Local tracks, albums and artists.
Playlists
Track collections saved by the user.
Video
Local video and network media.
Favourites
Quick access to marked tracks.
Settings
Audio, effects, appearance and application behaviour.

Music player

Playback controls
SCREENSHOT PLACEHOLDER Playback controls
Playback controls A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
Play / Pause
Starts or pauses the current track.
Stop
Stops playback and resets the current position.
Previous
Moves to the previous queue item.
Next
Moves to the next queue item.
Progress bar
Drag the indicator to seek within the track.
Volume
Controls playback level independently of DSP effects.
Shuffle and repeat
SCREENSHOT PLACEHOLDER Shuffle and repeat
Shuffle and repeat A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

Shuffle changes the playback order.

Repeat switches between no repeat, queue repeat and single-track repeat.

Cover artwork and track information
SCREENSHOT PLACEHOLDER Cover artwork and track information
Cover artwork and track information A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

The main screen displays cover artwork and track metadata.

Perun uses the default cover image when artwork is unavailable.

Library, queue and playlists

Opening tracks from the library
SCREENSHOT PLACEHOLDER Opening tracks from the library
Opening tracks from the library A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  1. Open the Music module.
  2. Select a track, album or artist.
  3. Tap a track to start playback.
  4. Other tracks from the selected view can become the queue.
Adding and removing queue items
SCREENSHOT PLACEHOLDER Adding and removing queue items
Adding and removing queue items A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

Add tracks through their menu, then manage them in the Queue module.

The currently playing track is highlighted in the queue.
Playlists
SCREENSHOT PLACEHOLDER Playlists
Playlists A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  1. Open the Playlists module.
  2. Create a new playlist and give it a name.
  3. Add tracks from the library or current-track menu.
  4. Tap a playlist to play its contents.
Favourites
SCREENSHOT PLACEHOLDER Favourites
Favourites A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

Mark tracks with the favourite icon to collect them in the Favourites module.

Audio engines and effects

Media3 and AMP
SCREENSHOT PLACEHOLDER Media3 and AMP
Media3 and AMP A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

Media3 is Perun's main engine with the custom PCM16 path.

AMP uses Android MediaPlayer as a compatibility mode.

  1. Open Settings.
  2. Expand the playback-engine section.
  3. Select Media3 or AMP.
Media3 and AMP equaliser settings are independent.
HiFi mode
SCREENSHOT PLACEHOLDER HiFi mode
HiFi mode A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

HiFi mode bypasses additional audio processing.

  1. Enable the Media3 engine.
  2. Expand the HiFi section.
  3. Enable the HiFi switch.
HiFi does not boost the sound.
Equaliser
SCREENSHOT PLACEHOLDER Equaliser
Equaliser A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  1. Open Settings and select the active engine.
  2. Enable the equaliser.
  3. Select a preset or adjust the bands manually.
  4. Test the setting with several different tracks.
Large boosts across several bands can cause clipping.
Bass
SCREENSHOT PLACEHOLDER Bass
Bass A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

Bass enhances low frequencies inside the Media3 PCM path.

  1. Enable Media3.
  2. Expand the Bass section.
  3. Increase the value gradually during playback.
High bass levels can distort heavily mastered tracks.
Stereo widening
SCREENSHOT PLACEHOLDER Stereo widening
Stereo widening A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

Stereo widening increases perceived soundstage width.

Increase the effect gradually to preserve the centre of the mix.
Reverb: rooms and halls
SCREENSHOT PLACEHOLDER Reverb: rooms and halls
Reverb: rooms and halls A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

Choose a space type and adjust the intensity.

  • Small room: short, subtle ambience.
  • Medium room: clearer space without a long tail.
  • Large room: wider and deeper ambience.
  • Hall: longer and more spacious reverb.

Video

Playing local video
SCREENSHOT PLACEHOLDER Playing local video
Playing local video A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  1. Open the Video module.
  2. Open the local video library.
  3. Tap a video thumbnail.
  4. Use the fullscreen control to expand the video.
Network video
SCREENSHOT PLACEHOLDER Network video
Network video A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  1. Open the network-video module.
  2. Search or paste a video address.
  3. Select a result to open the media.
Downloader Direct transfer into the downloader queue is the next integration stage.

Appearance and interface

Themes and colours
SCREENSHOT PLACEHOLDER Themes and colours
Themes and colours A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  1. Open Settings.
  2. Open the Interface section.
  3. Select a theme or configure interface colours.
  4. Select a custom background image if required.
Breathing cover effect
SCREENSHOT PLACEHOLDER Breathing cover effect
Breathing cover effect A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

The effect gently animates cover artwork during playback.

  1. Open Settings → Interface.
  2. Enable or disable the breathing-cover option.
Collapsible settings sections
SCREENSHOT PLACEHOLDER Collapsible settings sections
Collapsible settings sections A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.

Tap a section header to expand or collapse it.

Media3-specific options appear when that engine is enabled.

Troubleshooting

Music or video is missing
SCREENSHOT PLACEHOLDER Music or video is missing
Music or video is missing A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  • Check application permissions.
  • Make sure files are stored in an accessible location.
  • Reopen the library module.
Bass or equaliser causes distortion
SCREENSHOT PLACEHOLDER Bass or equaliser causes distortion
Bass or equaliser causes distortion A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  1. Reduce the Bass level.
  2. Reduce boosted equaliser bands.
  3. Compare the sound with HiFi enabled.
  4. Reduce player or device volume.
An audio effect is not audible
SCREENSHOT PLACEHOLDER An audio effect is not audible
An audio effect is not audible A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  • Check that Media3 is active.
  • Disable HiFi because it bypasses additional effects.
  • Check that the effect is enabled.
  • Use a stronger test value, then reduce it.
Unexpected behaviour after changing engine
SCREENSHOT PLACEHOLDER Unexpected behaviour after changing engine
Unexpected behaviour after changing engine A real application screenshot demonstrating this action will be placed here. The file can later be replaced without changing the page code.
  1. Stop playback.
  2. Switch the engine again.
  3. Start a track from the queue.
  4. Restart Perun Player if the issue remains.

The guide will grow with the application

Dedicated chapters will be added as further modules are completed.

PERUN PLAYER

A player built for people who want control

Perun remains in active development.

Contact