NEON ÄÄNITALLENNIN 1.0.1
Windows 10 / 11, 64-bittinen x64

KORJAUS 1.0.1
Korjaa PowerShellin tarkistuskomennon virheen:
NameError: name 'P' is not defined.
Pura uusi paketti vanhan ohjelmakansion päälle, hyväksy tiedostojen korvaus
ja suorita ASENNA.cmd uudelleen. Olemassa olevaa Pythonia käytetään uudelleen.

ASENNUS – ALOITA TÄSTÄ
1. Pura ZIP kokonaan esimerkiksi kansioon:
   C:\Users\oma_nimi\Documents\NeonTallennin
   Älä käynnistä ohjelmaa suoraan ZIP-paketin sisältä.
2. Kaksoisnapsauta ASENNA.cmd.
3. Asennus käyttää Python 3.12:n 64-bittistä versiota. Jos se puuttuu,
   asennus lataa virallisen Python 3.12.10 -asentimen python.orgista,
   tarkistaa digitaalisen allekirjoituksen ja asentaa Pythonin vain
   nykyiselle käyttäjälle. Ensimmäinen asennus tarvitsee silloin internetin.
   Windowsin koko koneen suojausasetuksia ei muuteta.
4. Tarvittavat äänikirjastot ovat mukana paketissa. Ne asennetaan ohjelman
   omaan .venv-kansioon. Asennus luo työpöydälle Neon Aanitallennin -kuvakkeen.
5. Käynnistä ohjelma pikakuvakkeesta tai KAYNNISTA.cmd-tiedostosta.
   Säilytä ohjelmakansio samassa paikassa. Siirron jälkeen aja ASENNA.cmd uudelleen.

Tämä paketti sisältää Python-ohjelman ja Windows-käynnistimet, ei valmiiksi
käännettyä itsenäistä EXE-tiedostoa. Päivittäinen käyttö tapahtuu pikakuvakkeella,
eikä käyttäjän tarvitse kirjoittaa komentoja. ARM-Windowsia ei ole testattu.

ÄÄNEN TALLENNUS
1. Valitse toistolaite, jonka kautta ääni kuuluu: kaiuttimet, kuulokkeet tai HDMI.
   Oletuksena valitaan Windowsin oletustoistolaitteen loopback-kanava.
2. Käynnistä musiikki, nettiradio, video tai muu haluamasi ääni.
3. Tarkista, että L- ja R-tasomittarit liikkuvat.
4. Valitse tallennuskansio ja halutessasi muuta tiedoston nimeä.
5. Paina TALLENNA tai F9. Kestolaskuri näyttää tiedostoon kirjoitetun äänen keston.
6. Paina LOPETA tai F10. Odota Tallennettu-ilmoitusta ennen ohjelman sulkemista.
7. Tallenne ilmestyy alapuolen luetteloon. Valitse se ja paina Toista tai
   kaksoisnapsauta sitä. Soitin näyttää toistetun ajan ja tiedoston kokonaiskeston.

Ohjelma kaappaa valitun toistolaitteen yhteisen äänen: musiikin, puheen,
selainäänen ja myös ilmoitusäänet. Se ei käytä mikrofonia. Useille eri
äänilaitteille ohjautuvia sovelluksia ei yhdistetä automaattisesti: ohjaa ne
Windowsissa samalle toistolaitteelle. Pelkkä laitteen vaihtaminen Windowsissa
ei siirrä jo käynnissä olevaa kaappausta toiseen laitteeseen.

Säädä toistolaite Windowsissa stereoksi ja näytteenottotaajuudeksi 44 100 tai
48 000 Hz. Myös 32 000 Hz hyväksytään. 5.1/7.1-laitteet torjutaan ilmoituksella,
jotta esimerkiksi keskikanavan puhe ei jäisi tallenteesta pois. Monolaite
kopioidaan molempiin tallenteen kanaviin; se ei luo aitoa stereota.

Tallennus ei ala automaattisesti ohjelman käynnistyessä. Tasomittari seuraa
valittua ääntä jo ennen tallennusta, mutta ääntä ei silloin tallenneta levylle.
Jotkin suojatut lähetykset, yksinomaisessa tilassa toimivat sovellukset tai
ääniajurit voivat estää loopback-kaappauksen. Valitun laitteen äänenvoimakkuus
ja mykistys voivat vaikuttaa kaappaukseen ajurista riippuen.

TASON SÄÄTÖ JA SÄRÖ
• Tallennustaso: −30…+12 dB. Oletus −3 dB.
• 0 dB ei lisää eikä vähennä kaapattua ääntä. Negatiivinen arvo vaimentaa.
• L- ja R-mittarit näyttävät tallennukseen menevän signaalin huipputason.
  −∞ tarkoittaa hiljaisuutta. Mittarit toimivat myös ennen tallennusta.
• Turvarajoitin vaimentaa molempia stereokanavia yhdessä ja pitää PCM-signaalin
  näytehuiput enintään −1 dBFS:ssa. Oletuksena rajoitin on käytössä.
• Jos tasovaroitus syttyy, pienennä lähdeohjelman tai tallentimen tasoa.
  Suosi kohtuullista lähtötasoa jatkuvan voimakkaan rajoittamisen sijaan.
• Jo lähteessä leikkautunutta tai säröytynyttä ääntä ei voi palauttaa tällä
  säädöllä. Rajoitin ei ole studiotasoinen true-peak-limiteri; MP3-pakkaus
  voi muuttaa dekoodattuja huippuja hieman.
• Kuuntelu-liukusäädin säätää vain tallenteen toistoa, ei tallennustasoa.

ASETUKSET
MP3: 320 / 256 / 192 / 128 kbit/s, stereo.
Oletus 320 kbit/s on MP3:n suurin vakiobittinopeus ja tämän ohjelman paras
MP3-laatu. MP3 on aina häviöllinen. Tallenne on noin 2,4 Mt minuutissa.

WAV: pakkaamaton PCM, 16 bit, stereo, toistolaitteen näytteenottotaajuus.
48 kHz:n WAV vie noin 11,5 Mt minuutissa. Tavallisen WAVin noin 4 Gt:n rajan
lähestyessä ohjelma lopettaa tallennuksen. Aloita silloin uusi tiedosto.

Teema: Tumma tai Vaalea. Asetukset ja tallennuskansio muistetaan.
Tallennusmuotoa muutetaan tallennusten välissä; tasoa ja rajoitinta voi säätää
myös tallennuksen aikana. Tallenteet toistetaan Windowsin oletustoistolaitteesta.
Ohjelman oma toisto pysähtyy tallennuksen alkaessa, eikä sitä voi käynnistää
kesken tallennuksen. Muut ohjelmat saavat edelleen toistaa ääntä normaalisti.

TIEDOSTOT JA VIRHETILANTEET
• Oletuskansio: käyttäjän Music\NeonTallenteet. Sen voi vaihtaa ohjelmassa.
• Olemassa olevia tiedostoja ei korvata: nimeen lisätään tarvittaessa numero.
• Tallennuksen aikana tiedoston pääte on .mp3.kesken tai .wav.kesken.
  Normaali pääte annetaan vasta onnistuneen viimeistelyn jälkeen.
• Äänipuskurin ylivuodon tai laitteen katkeamisen yhteydessä tallennus lopetetaan
  ja jo saatu osa yritetään tallentaa. Tarkista silloin tallenteen eheys.
• Sähkökatkon tai kaatumisen jälkeen .kesken-tiedosto voi jäädä kansioon.
  Ota siitä kopio ja poista kopiosta .kesken-pääte. Osa äänestä voi olla
  toistettavissa; viimeisiä sekunteja tai vioittunutta otsaketta ei taata.
• Tarkista vapaa levytila ennen pitkiä tallennuksia. Ohjelma kirjoittaa levylle
  jatkuvasti eikä säilytä koko tallennetta RAM-muistissa.
• Jos ääni ei näy: varmista toistolaite, käynnistä ääntä toisessa ohjelmassa,
  tarkista Windowsin äänenvoimakkuus ja paina Päivitä laitteet.
• Bluetooth-laitteen tilan vaihtuminen kesken käytön voi katkaista kaappauksen.
• Käynnistysongelmissa avaa VIANETSINTA.cmd. Virheilmoitus jää näkyviin.
• Asennus ei vaadi erillistä FFmpeg-asennusta tai virtuaalista äänikaapelia.
• Pienellä näytöllä koko ikkunan sisältöä voi vierittää oikeasta reunasta.

POISTAMINEN
Sulje ohjelma, poista ohjelmakansio ja työpöydän pikakuvake. Omat tallenteet
säilyvät valitussa tallennuskansiossa. Asetukset ovat:
%APPDATA%\NeonTallennin\asetukset.json
Asennettu Python on erillinen ohjelma; voit poistaa sen Windowsin asennettujen
sovellusten kautta, jos et tarvitse sitä muihin ohjelmiin.

TESTAUS JA RAJAUKSET
Testattu: MP3 320 kbit/s ja WAV-enkoodaus, stereokanavien erillisyys,
tallenteen kesto, gain, rajoittimen näytehuippukatto, nimien törmäyssuoja
sekä kaappausjonon aloitus/lopetus simuloidulla äänilaitteella.
Windows x64 / Python 3.12 -riippuvuuksien valmiit wheel-paketit on tarkistettu.
Varsinaista WASAPI-kaappausta, Windows-asenninta ja graafista käyttöliittymää
ei ole ajettu aidossa Windowsissa tässä toimitusympäristössä. Tee ensin lyhyt
koetallennus omalla äänilaitteellasi ennen pitkää tai tärkeää tallennusta.

LÄHDEKOODI JA LISENSSIT
Ohjelman lähdekoodi on mukana: NeonTallennin.py, capture.py ja audio_core.py.
Ohjelma toimitetaan GNU GPL v3 tai uudempi -lisenssillä, ilman takuuta.
Katso LICENSE.txt ja KIRJASTOT.txt. Alkuperäiset kirjastolisenssit ovat myös
wheel-pakettien sisällä ja erikseen licenses-kansiossa.
