Description
Valacuhi MP3 Player helps musicians and creators publish album-style MP3 playlists directly on WordPress.
It is intentionally lightweight: no external frontend libraries, no bloated builders, and no paid add-on dependency for core playback/download workflows.
It keeps the setup simple and fast while offering a feature combination that is often split across paid tiers in other plugins.
Features include:
– Album custom post type
– Shortcode embed: [valacuhi_mp3_player id=”123″]
– Play/Pause, Previous/Next, seek bar
– Mute/Unmute and Mix mode
– MP3 metadata extraction (title, artist, album, genre, duration)
– Embedded artwork extraction from MP3 files
– Per-track and album ZIP download buttons with counters
– Premium lightweight v0.4 interface
– v0.4.3 unified inline SVG control icon family
– v0.4.4 mobile control-row polish and clearer Mix active state
Notes for Site Owners
- Download counters are transient-based lightweight counters.
- They are useful for UI feedback, not long-term analytics.
Installation
- Upload the plugin files to the
/wp-content/plugins/valacuhi-mp3-playerdirectory, or install via WordPress Plugins screen. - Activate the plugin through the
Pluginsscreen in WordPress. - Go to
Albumsand create a new album. - Set featured image (album art fallback).
- Add MP3 files in
Album Tracksmetabox. - (Optional) Add Album ZIP URL.
- Publish album.
- Find the album ID:
- Open
Albums -> All Albums. - Hover the album title or click
Edit. - In the browser URL, find
post=123orpost.php?post=123. - Use that number in the shortcode.
- Open
- Use shortcode
[valacuhi_mp3_player id="YOUR_ALBUM_ID"]on any page/post.
FAQ
-
What Users Can Do in the Player?
-
- Select any track from the list
- Play/Pause
- Previous/Next track
- Seek through progress bar
- Mute/Unmute
- Toggle Mix mode
- Download individual tracks
- Download entire album ZIP (if configured)
-
Why are style changes not visible after update?
-
- F12, then right click on Reload button and choose “Empty cache and hard reload”.
- Plugin version updates append
?ver=0.4.6to CSS/JS for cache busting.
-
What about Metadata Behavior?
-
- Title: MP3
titletag, fallback to filename - Artist/Album/Genre: shown only when tag exists
- Duration: extracted from MP3 metadata
- Artwork: embedded MP3 image preferred; album featured image used as fallback
- Title: MP3
-
Why is metadata missing for some tracks?
-
Metadata is read from MP3 tags. If tags are missing in the file, those fields stay empty.
-
Why does artwork not appear?
-
Artwork is extracted from embedded MP3 image frames. If an MP3 has no embedded image, the album featured image is used.
-
Are download counters permanent analytics?
-
No. Counters use lightweight transients and are intended as simple UI feedback.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Valacuhi MP3 Player” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Valacuhi MP3 Player” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.4.6
- Prefixed CPT identifier from
albumtovalacuhi_albumfor directory compatibility - Added one-time migration of legacy
albumposts to the new prefixed CPT - Prefixed transient keys and AJAX action names to avoid cross-plugin collisions
- Reworked media URL-to-path resolution to use robust WordPress APIs
- Hardened track URLs POST handling for stricter validation/sanitization flow
0.4.5
- Switched audio metadata/artwork parsing to WordPress core APIs
- Plugin Check remediation pass for submission readiness
- Packaging cleanup for WordPress.org review
0.4.4
- Mobile-only control-row polish for small screens
- Centered Album CTA when it wraps to second row
- Stronger Mix on/off visual state clarity
0.4.3
- Unified inline SVG icon family for controls (prev/play-pause/next/mix/volume/download)
- Kept Play/Pause visually larger while secondary controls remain equal-sized
- Improved consistent icon rendering across environments
0.4
- Premium lightweight UI refresh (Frosted Light style)
- Improved visual hierarchy, controls, and track list styling
- WordPress.org hardening improvements
0.3.1
- Added genre extraction and display
- Added mute/unmute and mix controls
- Title fallback from MP3 title to filename
0.3
- Playback reliability improvements
- Embedded artwork shown in player and list
- Metadata extraction and progress UX improvements