README.md

Shelldio

Ένα απλό shell script για να παίζετε τους αγαπημένους σας ραδιοφωνικούς σταθμούς στο τερματικό.

Οδηγίες εγκατάστασης

Το Shelldio είναι συμβατό με Linux, BSD και macOS.

Arch Linux

Για να το κάνετε εγκατάσταση σε Arch Linux αρκεί να έχετε ενεργό το AUR οπότε, με έναν AUR helper κάντε εγκατάσταση το shelldio

yay -S shelldio

το οποίο θα κάνει αυτόματα εγκατάσταση το mpv και το curl που χρειάζεστε. Τώρα μπορείτε να πάτε παρακάτω στις οδηγίες χρήσης.

Στα υπόλοιπα λειτουργικά συστήματα

Για να το εγκαταστήσετε στα υπόλοιπα λειτουργικά συστήματα πρώτα κάνετε εγκατάσταση το MPV, το git (για να κάνετε λήψη του shelldio) και το curl (για την λήψη νέων σταθμών).

Σε Debian based διανομές

sudo apt install -y mpv git curl

Σε Fedora based διανομές

sudo dnf -y install mpv git curl

Σε OpenSuse Linux

sudo zypper in mpv git curl

Σε CentOS Linux (από το nux-desktop repository)

sudo yum -y install mpv git curl

Σε FreeBSD Unix

sudo pkg install mpv git curl

Σε macOS (μέσω Brew)

brew install mpv git curl

Τέλος αφού έχετε κάνει εγκατάσταση το MPV το git και το curl, τρέχετε μια μια τις παρακάτω εντολές για να εγκαταστήσετε το Shelldio:

git clone https://github.com/CerebruxCode/shelldio ~/shelldio
sudo ln -s ~/shelldio/shelldio.sh /usr/local/bin/shelldio

Η πρώτη εντολή θα δημιουργήσει έναν φάκελο shelldio στον home φάκελο του χρήστη σας και θα κατεβάσει την τελευταία σταθερή έκδοση, ενώ η δεύτερη εντολή θα δημιουργήσει μια συντόμευση του shelldio στο σύστημά σας για να μπορείτε απο την μια να κάνετε αναβάθμιση (όπως περιγράφουμε παρακάτω) αλλά και απο την άλλη να το εκτελείτε με μια απλή εντολή στο τερματικό.

Οδηγίες Αναβάθμισης

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

Arch Linux

Οι ενημερώσεις θα σας έρθουν αυτόματα την επόμενη φορά που θα κάνετε αναβάθμιση το Arch Linux σας και συγκεκριμένα στα πακέτα που προέρχονται απο το AUR.

Υπόλοιπα λειτουργικά συστήματα

Ξεκινώντας από την έκδοση v3.0.0 και έπειτα, δίδεται η δυνατότητα να κάνετε αναβάθμιση εκτελώντας την εντολη

shelldio -u

Για τις παλιότερες εκδόσεις, μπείτε στον φάκελο shelldio που κάνατε clone και τρέξετε pull. π.χ.

cd ~/shelldio
git pull

Λήψη νέων σταθμών

Για να κατεβάσετε νέους σταθμούς που μπορεί κατά καιρούς να προσθέτουμε, τρέξτε στο τερματικό :

shelldio --fresh

Οδηγίες Απεγκατάστασης

Ανάλογα του τρόπου εγκατάστασης μπορείτε να απεγκαταστήσετε το Shelldio με τους παρακάτω τρόπους

Arch Linux

Μπορείτε να το απεγκαταστήσετε με τον AUR helper σας π.χ.:

yay -Rcsu shelldio

Υπόλοιπα λειτουργικά συστήματα

Τρέξτε τις παρακάτω εντολές :

sudo unlink /usr/local/bin/shelldio

Τέλος μπορείτε να διαγράψετε και τον φάκελο που κατέβηκε με git clone

rm -rf ~/shelldio

macOS

sudo unlink /usr/local/bin/shelldio

Τέλος μπορείτε να διαγράψετε και τον φάκελο που κατέβηκε με git clone

rm -rf ~/shelldio

Οδηγίες χρήσης

Εξορισμού το script αν δε δοθεί όρισμα στο τερματικό ανοίγει τη λίστα με τους αγαπημένους σας σταθμούς (εφόσον υπάρχουν στο ~/.shelldio/my_stations.txt ).

Η κλασσική χρήση του γίνεται στο τερματικό με την εντολή:

shelldio

Αν θέλουμε να ξεκινήσουμε το shelldio με όρισμα τότε αυτό μπορεί να είναι ένα απο τα παρακάτω:

Χρήση: shelldio [όρισμα] Όπου [όρισμα] :

 <1-9>:  Γρήγορη εκκίνηση. Ξεκινάει την αναπαραγωγή του σταθμού απευθείας
   από τη θέση που δόθηκε ως όρισμα χωρίς να εμφανίζει την λίστα αγαπημένων μας.
   (π.χ. shelldio 4, ξεκινάει τον σταθμό που βρίσκεται στην θέση 4 από την λίστα των αγαπημένων μας)

 -a, --add:  Εμφανίζει την γενική λίστα με όλους τους διαθέσιμους ραδιοφωνικούς σταθμούς 
   και σας δίνει την δυνατότητα να προσθέσετε, όποια επιθυμείτε, στην λίστα με τα αγαπημένους σας
   σταθμούς (στο αρχείο ~/.shelldio/my_stations.txt)
   
 -n, --new: Σας δίνει την δυνατότητα να προσθέσετε έναν νέο σταθμό στην λίστα με τους αγαπημένους σας 
   ραδιοφωνικούς σταθμούς (στο αρχείο ~/.shelldio/my_stations.txt)
 
 -f, --fresh:  Κατεβάζει εκ νέου την γενική λίστα των ραδιοφωνικών σταθμών με επικαιροποιημένους
   ραδιοφωνικούς σταθμούς, διορθωμένα links αλλά και νέους ραδιοφωνικούς σταθμούς
 
 -h, --help:  Εμφανίζει αυτές τις πληροφορίες για την χρήση της εφαρμογής
 
 -j, --joker:  Ξεκινάει την αναπαραγωγή τυχαίου σταθμού

 -l, --list:  Εμφανίζει την γενική λίστα με τους ραδιοφωνικούς σταθμούς. Μπορείτε να χρησιμοποιήσετε
   την επιλογή αυτή σε συνδυασμό με άλλη εντολή. πχ. για να κάνετε αναζήτηση :
   
     shelldio -l | grep -i "onoma stathmou"
 
 -r, --remove:  Εμφανίζει την λίστα με τους σταθμούς που έχετε προσθέσει στα αγαπημένα σας και σας
   δίνει την δυνατότητα να αφαιρέσετε όποια θέλετε 
   (από το ~/.shelldio/my_stations.txt)

 -u, --update:  Σας δίνει την δυνατότητα να κάνετε αναβάθμιση του Shelldio στην νεότερη διαθέσιμη έκδοση.
   Προσοχή, η αναβάθμιση με αυτόν τον τρόπο ισχύει μόνο για αυτούς που έκαναν εγκατάσταση το shelldio
   με git clone και όχι απο πακέτο εγκατάστασης (π.χ. απο AUR σε Arch based Linux)

 --reset:  Προσοχή - Καθαρίζει τη λίστα με τους σταθμούς που έχετε προσθέσει στα αγαπημένα σας
   διαγράφοντας το αρχείο ~/.shelldio/my_stations.txt. Είναι χρήσιμο αν 
   θέλετε να ξεκινήσετε απο την αρχή την δημιουργία της λίστας των αγαπημένων σας.

Παράδειγμα:

shelldio

Θα φορτώσει τους αγαπημένους σας σταθμούς. Αλλιώς μπορείτε να φορτώσετε το μεγάλο αρχείο με πάνω απο 100+ σταθμούς με την παρακάτω εντολή:

shelldio --list

Στην ερώτηση που θα σας κάνει επιλέγετε f για να σας εμφανίσει όλη την λίστα.

Αναζήτηση με όνομα

Μπορείτε επίσης να κάνετε αναζήτηση για κάποιον σταθμό χρησιμοποιώντας την παρακάτω εντολή:

shelldio --list | grep -i "onoma_stathmou"

θα σας εμφανίσει τον αριθμό. Πατάτε Q για να σταματήσετε την αναζήτηση και έπειτα τρέχετε shelldio --add και βάζετε τον αριθμό του σταθμού που αναζητήσατε. Με αυτόν τον τρόπο μπορείτε να μαζέψετε π.χ. τους αγαπημένους σας σταθμούς και την επόμενη φορά που θα ξεκινήσετε το shelldio θα τα δείτε στην λίστα των αγαπημένων σας σταθμών.

Πως βάζω νέους σταθμούς

Αν γνωρίζετε το λινκ του σταθμού που θέλετε να βάλετε, παρακαλούμε ενημερώστε μας να το προσθέσουμε στο shelldio ανοίγοντας ένα issue

Αφού το προσθέσουμε μπορείτε να κατεβάσετε τους νέους σταθμούς, με την εντολή:

shelldio --fresh

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

Αν έχετε δικούς σας σταθμούς ή φίλων σας και είναι internetικά ραδιόφωνα, θα χαρούμε πολύ να τα προσθέσουμε στο shelldio ανοίγοντας μας ένα issue