Karaoke Monster MIDI

Tervetuloa Muvika MIDI Controllerin ohjekeskukseen. Valitse alta roolisi ja tarvitsemasi ohje.

Suomi English

⚠️ Tärkeää huomioitavaa asennuksessa:

🎤 Käyttäjän ohjeet ja ongelmanratkaisu

Nämä ohjeet koskevat laajennuksen päivittäistä käyttöä riippumatta siitä, mitä käyttöjärjestelmää tai taustamusiikkisovellusta käytät. Laajennuksen idea on yksinkertainen: Se lukee Muvikan taustamusiikin tilaa ja säätää ulkoisen laitteen volyymia sen mukaisesti.

Muista aina perusasiat: Muvika ohjaa vain taustamusiikin volumen liukusäädintä (faderia). Se ei osaa painaa taustamusiikkiohjelmastasi "Play"-nappia tai laittaa vahvistintasi päälle. Varmista siis ensimmäisenä, että ulkoinen musiikinlähteesi soi ja ääniasetukset ovat kunnossa!

0. Ennen kuin aloitat: Kiinnitä laajennus selaimeen (Pin)

Jotta pääset helposti käsiksi laajennuksen asetuksiin ja vianmääritykseen, kiinnitä se selaimesi yläpalkkiin:

  • Klikkaa selaimesi oikeasta yläkulmasta löytyvää Palapelin palanen -kuvaketta (Laajennukset).
  • Etsi listalta "Muvika MIDI Controller" ja paina sen vieressä olevaa Nasta-kuvaketta (Pin).
  • Jos asensit laajennuksen juuri äsken, muista päivittää Muvikan sivu (F5), jotta laajennus aktivoituu.

1. Ensimmäinen käynnistys ja taustamusiikin aktivointi

Kun avaat Muvikan, laajennus oletusarvoisesti vaimentaa taustamusiikin. Tämä on varotoimenpide: edellinen käyttäjä on saattanut jättää Muvikan mihin tahansa tilaan, ja näin vältämme kahden kappaleen päällekkäisen kakofonian.

  • Valitse Muvikassa Taustamusiikki -välilehti.
  • Laita täppä ruutuun "Soita taustamusiikkia karaokekappaleiden välissä", jolloin musiikki alkaa soida.
    Näytä kuva: Taustamusiikin aktivointi
  • Huom: Jos täppä oli jo valmiina ruudussa kun avasit sivun, ota se ensin pois ja laita takaisin, jotta laajennus saa käskyn nostaa volyymi.

2. TÄRKEÄÄ: Kakofonian estäminen (External Source -soittolista)

Ennen kuin valitset taustamusiikin soimaan, sinun on estettävä Muvikan sisäistä taustamusiikkia soimasta samaan aikaan ulkoisen musiikkisi (esim. Spotify) kanssa. Tähän on kaksi tapaa:

  1. Vedä Muvikan oma Taustamusiikin äänenvoimakkuus-liukusäädin (slideri) nollaan.
  2. Taikatemppu (Suositeltu): Käytä hiljaista "External source" -raitaa. Tämä on paras tapa ammattikäyttöön!
    Näytä kuva: Taustamusiikin volyymi ja lähde

Näin teet hiljaisen soittolistan:

  • Luo Muvikaan uusi soittolista nimeltä "External" (tai vastaava).
  • Käytä taustamusiikin hakutoimintoa ja hae kappale nimeltä External source (tämä on täysin äänetön raita). Klikkaa kappaletta, valitse luomasi "External" soittolista ja paina Lisää listalle.
    Näytä kuva: Kappaleen haku ja lisäys
  • Mene Soittolistat-välilehdelle ja valitse luomasi lista. Klikkaa "Play"-napin vieressä olevaa toistokuvaketta, kunnes siinä lukee KORVAA.
    Näytä kuva: Korvaa ja looppaa

Nyt Muvikan soittojono looppaa hiljaista biisiä ikuisesti, ja Muvikan oma ääni ei koskaan kajoa taustamusiikkisi päälle!

3. Tilachipit ja asetukset (Vianetsintä)

Laajennus lisää Muvikan sivulle (oletuksena vasempaan alareunaan) pienen kelluvan ikkunan ja värillisiä tilachippejä. Nämä kertovat reaaliajassa, mitä laajennus tekee. Niistä on valtava apu vianetsinnässä illan aikana.

  • Jos täppä "Soita taustamusiikkia" on otettu pois, tilachippi kertoo tämän, ja taustamusa liukuu alas.
  • Jos itse Karaoke on asetettu pauselle, myös taustamusiikki pysyy alhaalla (karaoke on keskeytetty, mutta "yhä käynnissä").
  • Jos tilachippejä ei näy, avaa laajennuksen Asetus-popup selaimesi yläpalkista (laajennusikonista) ja laita chipit näkyviin.
Näytä kuva: Asetukset ja tilachipit
Jos olet säätänyt asetuksia (esim. fade nopeus, max vol, fonttikoko) ja laite toimii oudosti, käytä popup-ikkunan alareunasta löytyvää "Palauta oletusasetukset" -linkkiä.

4. Ääni ei vieläkään kuulu? Tarkista laitteiston reititys

Jos laajennus näyttää toimivan selaimesi ruudulla (tilachipit päivittyvät), mutta ulkoinen taustamusiikki ei feidaudu tai kuulu ollenkaan, vika on todennäköisesti käyttöjärjestelmäsi virtuaalikaapeleissa.

  • Windows: Varmista, että loopMIDI on päällä ja Voicemeeterin reititykset ovat oikein. Avaa Windows-asennusohje.
  • Mac: Tarkista, että IAC Driver on "Online". Avaa Mac-asennusohje.
  • Linux: Varmista qpwgraphista, että Exclusive-tila on päällä ja johdot kulkevat soittimesta BG_MUSIC_ROUTERin läpi kaiuttimiin. Avaa Linux qpwgraph-ohje.
🔧 Asentajan oppaat (Setup)

Valitse alta käyttöjärjestelmäsi ja avaa tarkat asennusohjeet. Suosittelemme aloittamaan Selainlaajennuksen asennuksesta.

🌐 1. Selainlaajennuksen asennus (Kaikki laitteet)

Laajennus on toistaiseksi "pakkaamaton" (unpacked), joten se asennetaan kehittäjätilassa:

  • Lataa ja pura asennuskansio koneellesi (esim. työpöydälle).
  • Avaa selaimesi (Chrome/Edge) ja kirjoita osoiteriville chrome://extensions (tai edge://extensions).
  • Laita oikeasta yläkulmasta päälle Kehittäjätila (Developer mode).
  • Klikkaa vasemmasta yläkulmasta Lataa purettu laajennus (Load unpacked) ja valitse purkamasi kansio.
Huom: Kun avaat Muvikan sivun ensimmäistä kertaa laajennuksen asennuksen jälkeen, selain saattaa kysyä lupaa muodossa "Salli MIDI-laitteiden käyttö" tai "Allow MIDI devices". Vastaa tähän myöntävästi (Salli/Allow), jotta laajennus pystyy kommunikoimaan äänijärjestelmän kanssa.
Näytä kuva: Laajennuksen asennus
🪟 2. Windows Setuppi

Suositeltu: Voicemeeter + loopMIDI

Vaihe 1: loopMIDI

Asenna ilmainen loopMIDI. Avaa ohjelma ja luo uusi portti kirjoittamalla "New port-name" -kenttään KaraokeControl ja paina plussaa (+). Laita ohjelma käynnistymään Windowsin mukana.

Näytä kuva: loopMIDI asetukset

Vaihe 2: Voicemeeter Banana

Huom: Voicemeeter on ns. Donationware. Sitä voi käyttää ilmaiseksi, mutta trial-jakson jälkeen käynnistyksen yhteyteen tulee ilmoitusikkuna. Voit poistaa tämän ostamalla edullisen lisenssin heidän sivuiltaan.

Reititä äänet Windowsin Ääniasetukset → Sovelluskohtaiset äänenvoimakkuudet kautta:

  • Toinen selainikkuna (esim. YouTube uudessa selaimessa): Reititä Voicemeeter VAIO -tuloon.
  • Ulkoinen fyysinen lähde: Valitse Voicemeeterin Hardware Input 1 -valikosta äänikorttisi linjatulo.
Näytä kuva: Windowsin äänen reititys

Vaihe 3: MIDI Mäppäys

Avaa Voicemeeteristä Menu → M.I.D.I. Mapping. Varmista, että In-laitteena on loopMIDIn portti. Etsi taustamusiikin raidan fader ja paina "Learn", tai aseta siihen manuaalisesti CC17. (Karaoken Mute-napin voi halutessaan mapata CC16:een).

Näytä kuva: Voicemeeter MIDI Mapping

Vaihtoehtoiset: OBS Studio / VLC

OBS Studio Setuppi

Voit käyttää OBS Studiota äänimikserinä asentamalla siihen obs-midi-mg -pluginin. Reititä taustamusiikki (virtuaalikaapelilla tai ikkunakaappauksella) OBS:n ääniraidaksi. Käytä midi-pluginia sitomaan CC17 kyseisen raidan äänenvoimakkuuden säätimeen.

Näytä kuva: OBS MIDI Plugin

VLC Player Setuppi

VLC ei oletuksena ota vastaan MIDI-komentoja, mutta voit soittaa taustamusiikin VLC:llä ulos virtuaalikaapeliin, ja käyttää kevyttä erillistä apuohjelmaa (tai ylempänä mainittua OBS:ää) säätämään tuon kaapelin tasoa MIDIn avulla.

✅ Asennus valmis? Jos kaikki vaikuttaa menneen nappiin, siirry lukemaan Käyttäjän ohjeita.
🍎 3. Mac (macOS) Setuppi
Macissa et tarvitse loopMIDIä, sillä ominaisuus on sisäänrakennettu!
  • Avaa Audio MIDI Setup (Ääni- ja MIDI-asetukset) Macin Ohjelmat/Lisäohjelmat -kansiosta.
  • Valitse yläpalkista Window → Show MIDI Studio.
  • Tuplaklikkaa IAC Driver -ikonia ja rasta laatikko "Device is online". (Tämä vastaa loopMIDIä). Nyt laajennuksesi asetusikkunaan kannattaa syöttää MIDI-portin nimeksi IAC Driver Bus 1.
  • Käytä mikserinä ja reitittimenä esim. ilmaista BlackHole-virtuaalikaapelia yhdessä OBS Studion kanssa tai maksullista Loopback -ohjelmaa.
Näytä kuva: Mac IAC Driver asetukset
✅ Asennus valmis? Jos kaikki vaikuttaa menneen nappiin, siirry lukemaan Käyttäjän ohjeita.
🐧 4. Linux (PipeWire) Setuppi

Linuxilla setuppi on erittäin kevyt, sillä se korvaa raskaat Windows-mikserit yhdellä huomaamattomalla taustaskriptillä.

Vaihe 1: Asennus ja skriptin lataus

  1. Varmista, että käytät Chromium-pohjaista selainta (esim. Chrome, Edge, Brave). Firefoxin MIDI-tuki vaatii säätämistä.
  2. Avaa terminaali ja asenna vaaditut Python-kirjastot ja reititysohjelma komennolla:
    sudo apt update && sudo apt install -y python3-mido python3-rtmidi qpwgraph
  3. Lataa Python-daemon-skripti (.zip), pura se ja siirrä muvika_daemon.py kotihakemistoosi (esim. /home/KAYTTAJANIMI/).

Vaihe 2: Automaattinen taustapalvelu (Set & Forget)

Asetetaan skripti käynnistymään koneen mukana automaattisesti taustalle.

  1. Luo kansio käyttäjän palveluille:
    mkdir -p ~/.config/systemd/user/
  2. Avaa uusi tiedosto editorilla:
    nano ~/.config/systemd/user/muvika-midi.service
  3. Kopioi tiedostoon alla oleva sisältö. TÄRKEÄÄ: Muuta ExecStart-riville oma käyttäjänimesi! [Unit] Description=Muvika MIDI Controller Daemon After=pipewire.service [Service] Type=simple ExecStart=/usr/bin/python3 /home/KAYTTAJANIMI/muvika_daemon.py Restart=always RestartSec=3 [Install] WantedBy=default.target
  4. Tallenna (Ctrl+O, Enter) ja sulje (Ctrl+X).
  5. Ota palvelu käyttöön antamalla päätteessä nämä kaksi komentoa yksi kerrallaan (paina Enter välissä):
    systemctl --user daemon-reload
    systemctl --user enable --now muvika-midi.service

Vaihe 3: Äänten reititys (qpwgraph)

Lopuksi ohjataan taustamusiikki virtuaalikaapelin läpi. On tärkeää käyttää Exclusive-tilaa, jotta ääni ei kierrä tuplana!

  1. Avaa qpwgraph. Laita haluamasi taustamusiikkisovellus (esim. Spotify tai erillinen selain) ja Muvika soimaan.
  2. Klikkaa ylävalikosta Patchbay ja laita Exclusive-tila päälle (niin että siinä on täppä). Varmista myös, että yläpalkin Activated-nappi loistaa vihreänä.
  3. Irrota taustamusiikkisovelluksen suorat johdot pääkaiuttimiisi (esim. äänikorttisi tai emolevyn ulostulo) maalaamalla ne ja painamalla Delete.
  4. Vedä taustamusiikin ulostuloista johdot virtuaalikaapelin (BG_MUSIC_ROUTER) vasempaan reunaan.
  5. Vedä virtuaalikaapelin oikeasta reunasta (monitor) johdot takaisin pääkaiuttimiisi. Huom: Tämä on tärkeää, jotta ääni ei jää jumiin kaapeliin!
  6. Jätä Muvika (Chromium) menemään suoraan pääkaiuttimiin, jotta karaoke ei hiljene taustan mukana.
  7. Valitse ylävalikosta Patchbay → Save As... ja tallenna nimellä muvika_karaoke.qpwgraph.
Näytä kuva: qpwgraph kytkennät
Automaattinen käynnistys: Lisää Linuxin "Käynnistyssovellukset" -valikkoon uusi komento, jotta laite muistaa johdot aina käynnistyessään:
qpwgraph -m -a /home/KAYTTAJANIMI/muvika_karaoke.qpwgraph

Vianmääritys (Troubleshooting Linux)

  • Permission denied: Yritit ajaa skriptiä manuaalisesti ilman python-tulkki-komentoa. Oikea komento manuaaliseen testiin on aina python3 /polku/tiedostoon.py
  • ModuleNotFoundError: 'mido': Asennuskomento unohtui. Aja päätteessä uudelleen: sudo apt install python3-mido python3-rtmidi
  • Listalla on kaksi BG_MUSIC_ROUTER -kaapelia: Jos skripti käynnistettiin vahingossa kahdesti (manuaalisesti ja palveluna), sammuta palvelu (systemctl --user stop muvika-midi.service), poista haamukaapelit (pactl unload-module module-null-sink) ja käynnistä palvelu puhtaalta pöydältä (systemctl --user start muvika-midi.service).
  • Taustamusiikki ei soi / ääni ei kuulu: Tarkista Linuxin omat ääniasetukset. Jos virtuaalikaapelin (BG_MUSIC_ROUTER) taso on 0%, se odottaa selainlaajennukselta "saa soida" -komentoa. Varmista myös, että qpwgraphissa johdot todella jatkuvat kaapelista ulos kaiuttimille saakka.
  • Taustamusiikki menee suoraan ohi ja kaapelin läpi yhtä aikaa: Muista laittaa qpwgraphista Exclusive-tila päälle (Patchbay-valikosta) ennen kuin muutat johtoja tai vaihdat tallennettua profiilia!
✅ Asennus valmis? Jos kaikki vaikuttaa menneen nappiin, siirry lukemaan Käyttäjän ohjeita.
⬇ Siirry lataussivulle ← Palaa etusivulle