SEPON MUSIIKKISOITIN — LINUX
==========================
Graafinen työpöytäsovellus: Python 3.8+, GTK 3 ja GStreamer 1.0.
Ei Wineä, Windowsia, käyttäjätiliä eikä maksullisia kirjastoja.

ALOITUS: UBUNTU / LINUX MINT / DEBIAN
1. Pura ZIP esimerkiksi kotikansioosi.
2. Asenna riippuvuudet kerran avaamalla Pääte ja suorittamalla:

sudo apt update
sudo apt install python3 python3-gi gir1.2-gtk-3.0 gir1.2-gstreamer-1.0 gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav

3. Avaa purettu SeponMusiikkisoitin-Linux-kansio tiedostonhallinnassa.
   Valitse hiiren oikealla painikkeella "Avaa päätteessä" ja suorita:

bash Kaynnista-musiikkisoitin.sh

Ensiasennus tarvitsee Internetin ja ylläpitäjän salasanan riippuvuuksien
asentamiseksi. Itse soitin toimii paikallisesti ilman verkkoyhteyttä.
Ohjelmaa ei käynnistetä sudolla.

MUUT JAKELUT
Fedora: perusriippuvuudet voi asentaa komennolla:
sudo dnf install python3 python3-gobject gtk3 gstreamer1-plugins-base gstreamer1-plugins-good

Arch Linux:
sudo pacman -S python python-gobject gtk3 gstreamer gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav

Koodekkien saatavuus vaihtelee jakelun mukaan. Esimerkiksi AAC- tai WMA-
tiedosto voi tarvita lisää jakelusi tarjoamia GStreamer-koodekkeja.
Käynnistysskripti käyttää /usr/bin/python3-järjestelmätulkkia.

KÄYTTÖ
- VALITSE KANSIO etsii musiikin myös sen alikansioista.
- Kaksoisnapsauta kappaletta käynnistääksesi sen.
- Hae kappaleen nimen perusteella hakukentällä.
- Toista / Tauko, Edellinen ja Seuraava ohjaavat toistoa.
- Etenemispalkista voi siirtyä toiseen kohtaan kappaletta.
- Äänenvoimakkuus ja Satunnaistoisto ovat ikkunan alareunassa.
- Kappaleen lopussa siirrytään seuraavaan. Lista kiertää alusta uudelleen.
- Seuraava ja satunnaistoisto käyttävät koko valittua musiikkikansiota,
  eivät vain hakutuloksia.
- Viimeksi valittu musiikkikansio ja äänenvoimakkuus muistetaan.
- Tuetut päätteet: MP3, WAV, WMA, M4A, AAC, FLAC, OGG ja OPUS.
  Varsinainen toisto riippuu asennetuista koodekeista.

KOPIOINTI TOISEEN KANSIOON TAI USB-MUISTILLE
1. Valitse kappale listalta yhdellä napsautuksella.
2. Paina KOPIOI KAPPALE… ja valitse kohdekansio.
3. Ohjelma ilmoittaa valmistumisesta.
Kopioidaan valittu kappale, vaikka toinen kappale olisi soimassa.
Alkuperäinen säilyy. Samannimisiä tiedostoja ei korvata: kopio saa esimerkiksi
nimen Kappale (1).mp3. Peruuta sulkee kansiovalinnan kopioimatta.
Odota valmistumisilmoitusta ennen USB-muistin irrottamista ja irrota muisti
sen jälkeen työpöydän turvallisella poistotoiminnolla.

VIANHAKU
"No module named gi" / "Namespace ... not available": asenna riippuvuudet
ja käytä yllä olevaa bash-käynnistyskomentoa virtuaaliympäristön sijaan.
Jos ääntä ei kuulu, tarkista työpöydän ääniulostulo ja äänenvoimakkuus.
Toistovirhe näytetään ikkunassa; tarkista tiedosto ja koodekit.
Ohjelma tarvitsee Linuxin graafisen työpöydän (X11 tai Wayland).

Asetukset: ~/.config/sepon-musiikkisoitin/asetukset.json
(tai XDG_CONFIG_HOME-ympäristömuuttujan määrittämä kansio).
Poistaminen: poista ohjelmakansio ja halutessasi yllä oleva asetuskansio.
Musiikkitiedostot säilyvät.

TARKISTUKSET
Python-koodi on syntaksitarkistettu, ja kopiointi on testattu tavallisilla
sekä erikoismerkkejä sisältävillä nimillä ja samannimisillä kohdetiedostoilla.
GTK-käyttöliittymää ja äänentoistoa ei ole ajettu tämän paketin tekemiseen
käytetyssä ympäristössä, josta GTK/GStreamer-riippuvuudet puuttuvat.

Tekninen dokumentaatio:
https://pygobject.gnome.org/getting_started.html
https://gstreamer.freedesktop.org/documentation/playback/playbin.html
