About Local Audio Files MP3-DB

The Local Audio Files DB is a combination of a Module and a SiteProfile. It is intended to import MP3-files from your filesystem into ProcessWire, read ID3-Tags and pull coverImages from it to feed the DB.

Category 1Photo/Video/Audio
Modules that perform some function related to media such as photos and audio/video.
Category 2Site Profiles
A site profile represents a full ProcessWire site ready to be installed.
Release StateBeta
Close to stable, but users are advised to be cautious and test thoroughly.*
Authorhorst
Module Version0.1.5
Class NameLocalAudioFiles
Compatibility2.3, 2.4, 2.5, 2.6, 2.7
Date AddedJune 15, 2013
Last UpdatedSeptember 8, 2015
Recommended ByNew recommendations may take up to 1 day to appear.

Details

Local Audio Files - MP3-DB

The Local Audio Files DB is a combination of a Module and a SiteProfile. It is intended to import MP3-files from your filesystem into ProcessWire, read ID3-Tags and pull coverImages from it to feed the DB.


How does it work?

  • The Site has 4 sibling Tree Branches: genres - artists - albums - songs.
  • Each of them hold child-pages: genre - artist - album - song.
  • The logical relations are nested parent-children ones: a genre hold artists, each artist hold albums, each album hold songs.
  • To support both, slim and fast data relations & the logical hirarchy, the module extends the ProcessWire variable $page with some additions. It uses the addHookProperty mechanism to achieve that.
  • It uses an own caching mechanism for large lists, that can be prebuild when running the importer-shellscript, or it build the cache on demand.
  • Also it comes with a FrontEndHandler class that provides a lot of functionality, for example fully customizable FormSelectFields of all genres, artists or albums.
  • More detailed informations and code examples are collected in a demo section of the site.
The extended $page variable together with the LocalAudioFiles-FrontEndHandler gives you comprehensive tools to work with your music collection.

Instructions

How to Install

Grab a copy of the latest ProcessWire. Replace the install, modules and templates directories with those in this profile, as shown below:

  • /site-default/install/
  • /site-default/modules/
  • /site-default/templates/
With SiteProfile-Installs normally that is all there is to do. With this Profile you also have to copy the file LocalAudioFilesImportShellScript.php (for simplicity) to your PW-rootfolder, (where the index.php reside). If you are on Windows you also should copy mp3_import_starter4win.cmd to the same location.

Now install ProcessWire as per the instructions included with it and it will install the LocalAudioFiles profile automatically.

After that you find a Quickstart Guide at the homepage of the profile where you are advised to follow 2 steps before you are done!

Enjoy!

README

#LocalAudioFiles - MP3-DB#

###A ProcessWire (2.3.0+) Siteprofile###

####Livedemo: http://pwlaf.biriba.de/ ####

The Local Audio Files DB is a combination of a Module and a SiteProfile. It is intended to import MP3-files from your filesystem into ProcessWire, read ID3-Tags and pull coverImages from it to feed the DB.

####How does it work?####

  • The Site has 4 sibling Tree Branches: genres - artists - albums - songs
  • Each of them hold child-pages: genre - artist - album - song
  • The logical relations are nested parent-children ones: a genre hold artists, each artist hold albums, each album hold songs
  • To support both, slim and fast data relations & the logical hirarchy, the module extends the ProcessWire variable $page with some additions. It uses the addHookProperty mechanism to achieve that
  • It uses an own caching mechanism for large lists, that can be prebuild when running the importer-shellscript, or it build the cache on demand
  • Also it comes with a FrontEndHandler class that provides a lot of functionality, for example fully customizable FormSelectFields of all genres, artists or albums
  • More detailed informations and code examples are collected in a demo section of the site

The extended $page variable together with the LocalAudioFiles-FrontEndHandler gives you comprehensive tools to work with your music collection.

Comments

  • Jim Davis

    Jim Davis 3 years ago 10

    Google Chrome gives a "malicious file" block on this download (from the Download Zip link here). Maybe because it is an attachment?

    Just FYI. I got-it-from-git.

  • ryan

    ryan 3 years ago 10

    The download links from the forum generally don't work unless you are actually in the forum ahead of time (files appear to be session verified). I have updated the download link for this module to point to the GitHub zip file rather than the forum URL that doesn't work.

  • Samuel

    Samuel 3 years ago 10

    its a good site

  • Samuel

    Samuel 3 years ago 00

    its a good site

Post a Comment

Your e-mail is kept confidential and not included with your comment. Website is optional.