Οδηγίες εγκατάστασης και χρήσης

Περιεχόμενα

ΕΓΚΑΤΑΣΤΑΣΗ

– Δημιουργούμε μία βάση στην mysql. Δεν χρειάζεται να γίνει import κάποιο sql script. Η εφαρμογή θα δημιουργήσει αυτόματα όλο το structure της βάσης

– Κατεβάζουμε από εδώ τα αρχεία της εφαρμογής στον φάκελο που θέλουμε στον web server. Ή με download ή απευθείας με git

git clone https://rocean@bitbucket.org/rocean/owmp.git /myWebServerPath

Το project στο bitbucket.org είναι εδώ.

– Μετονομάζουμε το libraries/config.inc.php.sample σε libraries/config.inc.php και βάζουμε τα στοιχεία της mysql

Επίσης πειράζουμε την γραμμή

define ('PROJECT_PATH','/OpenWebMediaPlayer/');

και βάζουμε το directory στο οποίο έχουμε κατεβάσει την εφαρμογή

define ('PROJECT_PATH','/');

αν είναι στο root του web server.

ΑΡΧΙΚΕΣ ΡΥΘΜΙΣΕΙΣ

– Τρέχουμε την εφαρμογή και δημιουργούμε τον πρώτο admin χρήστη.

Με την δημιουργία του χρήστη δημιουργούνται αυτόματα και οι αρχικές τιμές στα options

– Κάνουμε login στην εφαρμογή και πάμε στις ρυθμίσεις, στα options, για να κάνουμε όσες αλλαγές θέλουμε.

– Πάμε στην Συλλογή και προσθέτουμε τις διαδρομές που βρίσκονται τα αρχεία της μουσικής μας συλλογής, για να μπορέσει η εφαρμογή μετά να τα εισάγει στην βάση δεδομένων.

Σε κάθε σημείο της εφαρμογής, που χρειάζεται, υπάρχει ένα εικονίδιο ερωτηματικού που πατώντας το εμφανίζει λεπτομερείς οδηγίες για το συγκεκριμένο σημείο.

ΑΠΑΙΤΗΣΕΙΣ ΕΦΑΡΜΟΓΗΣ

Απαιτεί εγκατάσταση σε linux (Apache, PHP, mySQL), γιατί χρησιμοποιούνται κάποιες linux εφαρμογές και άλλες command line εντολές.

ΓΝΩΣΤΑ ΠΡΟΒΛΗΜΑΤΑ

Προσοχή στα filenames των αρχείων να μην έχουν περίεργους ειδικούς χαρακτήρες, αλλιώς δεν θα αναγνωρίζονται και θα βγάζει πρόβλημα στον συγχρονισμό. π.χ. αν ένα αρχείο έχει τον χαρακτήρα ‘+’ τότε «χτυπάει».

Πρόβλημα έχει και με τα Ελληνικά metatags σε κάποια mp3. Περνιούνται στην database αλλά σε κάποια μπορεί να βλέπει «κινέζικα».

Το interface σε καμιά περίπτωση δεν είναι τελειωμένο, αλλά τα βασικά γίνονται κανονικά.

Ο player παίζει ακόμη μόνο σε autoplay και shuffle. Δηλαδή με κάθε αναζήτηση παίζει αυτόματα τα τραγούδια σε τυχαία σειρά.

Χρειάζεται μετάφραση στα Αγγλικά σε κάποια κείμενα βοήθειας.

ΣΗΜΕΙΩΣΕΙΣ

Για τα αρχεία σας δεν υπάρχει πρόβλημα να διαγράψει κάτι. Όπου χρειάζεται (όταν πατήσουμε εμείς διαγραφή) ρωτάει πρώτα για επιβεβαίωση. Ενώ όταν θέλει να διαγράψει μαζικά αρχεία (στον συγχρονισμό π.χ αν βρει διπλά αρχεία) πάλι ρωτάει και χρειάζεται επιβεβαίωση.

Επίσης δεν κάνει edit κανένα αρχείο. Όλα τα metadata γράφονται στην βάση δεδομένων και τα artworks σώζονται σε σχετικό directory.

UPDATE ΤΩΝ ΑΡΧΕΙΩΝ ΤΗΣ ΕΦΑΡΜΟΓΗΣ

Κατεβάζουμε τα αρχεία από το project και τα αντιγράφουμε πάνω στα προηγούμενα. Εναλλακτικά χρησιμοποιούμε το git για αυτόματα

sudo git pull

ΜΑΖΙΚΟ ΣΒΗΣΙΜΟ ΤΗΣ ΣΥΛΛΟΓΗΣ

Αν χρειαστεί να κάνετε δοκιμές στην αρχή και θέλετε να σβήσετε ότι έχετε συγχρονίσει, για να ξαναδοκιμάσετε, 2 είναι οι σχετικοί πίνακες που αφορούν την library. Ο files και ο music_tags. Επειδή υπάρχει συσχετισμός πρέπει να σβήσετε πρωτα τα περιεχόμενα του music_tags και μετά του files.

Δηλαδή οι εντολές που θα τρέξετε στην mysql είναι:

DELETE FROM music_tags;
DELETE FROM files;