EradioParser

e-radio.gr playlist generator
by Lappas Dionysis

> UPDATE (23/10/2013)

Κατεβάστε το eradioParser v2.0 με γραφικό περιβάλλον!

Περιεχόμενα

• Γενική εισαγωγή
• Το πρόγραμμα
• Το μενού
  • Επιλογές του μενού
• Πως τρέχω το πρόγραμμα;
  • Σε περιβάλλον Windows
  • Σε περιβάλλον Mac
  • Σε περιβάλλον GNU/Linux
• Τι αρχεία παράγει το πρόγραμμα;
• Υπάρχουν έτοιμα playlist να κατεβάσω;
• Command Line Arguments (ορίσματα γραμμής εντολών)
  • Εκτέλεση με command line arguments
  • Τρόποι εκτέλεσης σύνοψη
• Μηνύματα κατά την εκτέλεση
• Που υπάρχει ο πηγαίος κώδικας;
• Που μπορώ να διαβάσω τα JavaDocs;
• Download

Οδηγός αναφοράς για v1.1 (30 Απριλίου 2012)

Γενική εισαγωγή

Στο http://e-radio.gr βρίσκονται καταχωρημένα τα περισσότερα ελληνικά ραδιόφωνα (διαδικτυακά και μη). Όταν κάποιος θέλει να ακούσει ένα ραδιόφωνο, συνήθως ανοίγει τον browser, πλοηγείται στο συγκεκριμένο site, επιλέγει το σταθμό της αρεσκείας του από τις σχετικές λίστες και ακολούθως ο browser φορτώνει κάποιο πρόσθετο (plugin) προκειμένου να ξεκινήσει η αναπαραγωγή του σταθμού (το streaming όπως λέγεται καθώς είναι ένα ρεύμα δεδομένων που μεταδίδεται, μεταφέρεται κι αναπαράγεται σε πραγματικό χρόνο). Ωστόσο, η παραπάνω διαδικασία έχει τα εξής μειονεκτήματα για το χρήστη:

• καθυστέρηση μέχρι να ανοίξει ο browser, να φορτώσει η σελίδα, να επιλέξουμε το σταθμό και να ξεκινήσει η αναπαραγωγή.
• διακοπή της αναπαραγωγής σε περίπτωση που ο browser ή το πρόσθετο (plugin) τερματίσει απρόσμενα λόγω σφάλματος.
• διακοπή της αναπαραγωγής κι επανάληψη της διαδικασίας σε περίπτωση που ο χρήστης τερματίσει κατά λάθος τον browser ή το παράθυρο αναπαραγωγής.
• αυξημένη χρήση πόρων του συστήματος.
• εκνευρισμό από όλα τα παραπάνω.

Το πρόγραμμα

Το EradioParser δίνει τη δυνατότητα σε κάθε χρήστη να δημιουργεί playlists από το http://e-radio.gr. Το πρόγραμμα φορτώνει το μενού με τις κατηγοριοποιήσεις των σταθμών, όπως καταχωρούνται στο e-radio.gr (δηλαδή έχει το ίδιο μενού με το e-radio.gr) και με βάση την επιλογή του χρήστη δημιουργεί ένα τελικό playlist. Κατ' αυτόν τον τρόπο, αποφεύγονται όλα τα μειονεκτήματα που προαναφέρθηκαν και αρκεί μόνο ο χρήστης να αναπαράγει το playlist με τον vlc player και να επιλέξει το σταθμό που επιθυμεί!

Τα playlists που παράγει είναι της μορφής .xspf. Το συγκεκριμένο format είναι portable, δηλαδή μπορείτε να αναπαράγετε το ίδιο αρχείο σε όλα τα λειτουργικά συστήματα χωρίς κανένα πρόβλημα.

Το πρόγραμμα είναι γραμμμένο σε Java κι επομένως τρέχει σε όλα τα λειτουργικά συστήματα (Windows, Mac, GNU/Linux e.t.c.).

Είναι free software, υπάγεται στην άδεια GPL v3.0, γεγονός που σημαίνει ότι ο καθένας μπορεί να το χρησιμοποιήσει και να το αναδιανείμει ελεύθερα, ενώ μπορεί να δει και τον πηγαίο κώδικα.

Είναι σημαντικό να τονιστεί ότι το πρόγραμμα γράφτηκε με στόχο να μπορεί να το χρησιμοποιεί ο κάθε χρήστης, ακόμα και ο πιο άπειρος και δεν απαιτεί καμία ιδιαίτερη γνώση.

Το μενού

Το μενού του προγράμματος φαίνεται παρακάτω:

Επιλογές του μενού

1. Get a playlist for all the stations at <e-radio.gr>.
   Δημιουργεί ένα playlist με όλους του σταθμούς που υπάρχουν καταχωρημένοι στο e-radio.gr.

2. View the available station Categories and get a playlist.
   Προβάλλει το μενού με τις κατηγορίες των σταθμών ανά μουσικό είδος.
   
   
   Ο χρήστης επιλέγει μια κατηγορία και το πρόγραμμα δημιουργεί ένα playlist.

3. View the available station Locations and get a playlist.
   Προβάλλει το μενού με τις κατηγορίες των σταθμών ανά γεωγραφική περιοχή.
   
   
   Ο χρήστης επιλέγει μια κατηγορία και το πρόγραμμα δημιουργεί ένα playlist.

4. View the station Ratings (Top) and get a playlist.
   Προβάλλει το μενού με τις κατηγορίες των σταθμών με βάση τις αξιολογήσεις (Ratings).
   
   
   Ο χρήστης επιλέγει μια κατηγορία και το πρόγραμμα δημιουργεί ένα playlist. Για τις επιλογές 2, 3, 5, 6, 8, 9 πρώτα προβάλλεται το σχετικό υπο-μενού και κατόπιν ο χρήστης καλείται να κάνει την επιλογή του.

Πως τρέχω το πρόγραμμα;

Σε περιβάλλον Windows

1. Κατεβάζουμε το πρόγραμμα και το αποθηκεύουμε στο Desktop.
2. Ανοίγουμε το Command prompt: Start -> All Programs -> Accessories -> Command Prompt
3. Πληκτρολογούμε:
   cd desktop [και πατάμε Enter]
4. Πληκτρολογούμε:
   java -jar eradioParser-1.1.jar [και πατάμε Enter]
5. Ακολουθούμε το menu και σε λίγα δευτερόλεπτα το πρόγραμμα παράγει στο Desktop το επιθυμητό playlist με όνομα αρχείου: playlist.xspf
6. Αναπαράγουμε με τον vlc player.

Σε περιβάλλον Mac

1. Κατεβάζουμε το πρόγραμμα και το αποθηκεύουμε στο Desktop
2. Ανοίγουμε το terminal.
3. Πληκτρολογούμε:
   cd Desktop [και πατάμε Enter]
4. Πληκτρολογούμε:
   java -jar eradioParser-1.1.jar [και πατάμε Enter]
5. Ακολουθούμε το menu και σε λίγα δευτερόλεπτα το πρόγραμμα παράγει στο Desktop το επιθυμητό playlist με όνομα αρχείου: playlist.xspf
6. Αναπαράγουμε με τον vlc player.

Σε περιβάλλον GNU/Linux

1. Κατεβάζουμε το πρόγραμμα και το αποθηκεύουμε στο Desktop
2. Ανοίγουμε το terminal.
3. Πληκτρολογούμε:
   cd Desktop [και πατάμε Enter]
4. Πληκτρολογούμε:
   java -jar eradioParser-1.1.jar [και πατάμε Enter]
5. Ακολουθούμε το menu και σε λίγα δευτερόλεπτα το πρόγραμμα παράγει στο Desktop το επιθυμητό playlist με όνομα αρχείου: playlist.xspf
6. Αναπαράγουμε με τον vlc player.

Τι αρχεία παράγει το πρόγραμμα;

Το πρόγραμμα παράγει μέχρι και 3 διαφορετικά αρχεία. Τα αρχεία είναι τα εξής:

• playlist.xspf. Εϊναι το ζητούμενο playlist.
• eradio_BAD_links.txt. Αρχείο που περιέχει τα links και τα ονόματα των σταθμών που δεν ήταν έγκυρα.
• Unprocessed_links_probably_BAD.txt. Αρχεία που περιέχει τα links και τα ονόματα των σταθμών που απορρίφθηκαν πριν την επεξεργασία επειδή δεν ήταν έγκυρα.

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

Υπάρχουν έτοιμα playlist να κατεβάσω;

Φυσικά! Έχουν δημιουργηθεί τα δυνατά playlists που μπορεί να πάρει κανείς χρησιμοποιώντας τις επιλογές 1,2 και 3 του μενού του προγράμματος. Η 4η επιλογή του μενού (Ratings) δεν έχει χρησιμοποιηθεί καθότι τα playlists δεν έχουν νόημα αν δεν είναι επίκαιρα. Ακόμα περισσότερα playlist μπορεί να δημιουργήσει κανείς χρησιμοποιώντας command line arguments (δείτε παρακάτω)! Τα παρακάτω playlists έχουν δημιουργηθεί στις 30 Απριλίου 2012.

Elapsed time: Χρόνος εκτέλεσης του eradioParser (στο PC μου) σε milli second.
Parsed: Links που βρέθηκαν για επεξεργασία.
Valid: Links που αντιστοιχούν σε έγκυρες διευθύνσεις.
Unparsed: Links που απορρίφθηκαν πριν το στάδιο της επεξεργασίας (probably bad).

Command Line Arguments (ορίσματα γραμμής εντολών)

Το eradioParser υποστηρίζει ορίσματα γραμμής εντολών. Συγκεκριμένα υποστηρίζει τα εξής ορίσματα:

• File path. Το path ενός αρχείου στο δίσκο. Το αρχείο πρέπει να περιέχει urls και μάλιστα ένα ανά σειρά.
• Urls. Τα urls πρέπει να διαχωρίζονται με ένα κενό μεταξύ τους και μπορεί να είναι ένα ή περισσότερα.

Τι urls μπορεί να βάλει ο χρήστης και που θα τα βρει;

Τα urls πρέπει να είναι κάποια κατηγορίας μουσικού είδους (π.χ. Rock), ή τοποθεσίας (π.χ. Αθήνα) ή αξιολόγησης (π.χ. Daily Top50), ή συνδυασμός αυτών. Ο χρήστης μπορεί να βρει εύκολα τα urls αν επισκεφθεί το http://e-radio.gr και κατόπον πηγαίνοντας στο μενού κάνει δεξί κλικ και copy link address στην επιλογή που τον ενδιαφέρει, όπως φαίνεται παρακάτω:

Επομένως, είτε μπορεί να αποθηκεύσει αυτά τα urls σε ένα αρχείο (ένα ανά σειρά) και να δώσει το όνομα του αρχείου κατά την εκτέλση του προγράμματος ώστε να τα επεξεργαστεί, είτε μπορεί να εισάγει ο ίδιος τα urls που επιθυμεί (διαχωρισμένα με κενό).

Εκτέλεση με command line arguments

Αν θέλουμε λοιπόν να εισάγουμε command line arguments, το πρόγραμμα εκτελείται ως εξής:

• Με όρισμα το path του αρχείου
  java -jar eradioParser-1.1.jar [filePath]
π.χ. java -jar eradioParser-1.1.jar C:\Dio\myFile.txt [σε Windwos]
java -jar eradioParser-1.1.jar /Dio/myFile.txt [σε Mac και GNU/Linux]
• Με ορίσματα urls (ένα ή περισσότερα)
  java -jar eradioParser-1.1.jar [url] [url] [url]...[url]
π.χ. java -jar eradioParser-1.1.jar http://www.e-radio.gr/locations/athens.asp http://www.e-radio.gr/categories/greekhits.asp http://www.e-radio.gr/ratings/top.asp?iv=d

Κατ'αυτόν τον τρόπο, μπορούμε να δημιουργήσουμε συνδυασμένα playlists (είναι πάρα πολλοί οι δυνατοί συνδυασμοί) με βάση τις προτιμήσεις μας.

Τρόποι εκτέλεσης σύνοψη

• Xωρίς ορίσματα: $java -jar eradioParser-1.1.jar
• Με όρισμα το path του αρχείου: $java -jar eradioParser-1.1.jar [filePath]
• Με ορίσματα urls (ένα ή περισσότερα): $java -jar eradioParser-1.1.jar [url] [url] [url]...[url]

Μηνύματα κατά την εκτέλεση

Τα μηνύματα που τυπώνονται κατά την εκτέλεση είναι ενδεικτικά/ενημερωτικά της πορείας εκτέλεσης του προγράμματος και δεν πρέπει να απασχολούν το χρήστη. Το πρόγραμμα σε καμία περίπτωση δεν κολλάει ούτε μπορεί να τερματίσει απρόσμενα λόγω σφάλματος! Μετά το πέρας της εκτέλεσης τυπώνεται μια σύνοψη, όπως φαίνεται παρακάτω:

Που υπάρχει ο πηγαίος κώδικας;

Ο πηγαίος κώδικας βρίσκεται σε public repository στο Github.com και μπορείτε να τον δείτε εδώ, μαζί με όλες τις βιβλιοθήκες και τα σχετικά αρχεία ανάπτυξης του προγράμματος.

Που μπορώ να διαβάσω τα JavaDocs;

Τα JavaDocs μπορεί κανείς να τα διαβάσει από εδώ

Download

Download eradioParser v1.1