The following will take 15-30 minutes per laptop. Do multiple in parallel, where possible. We have 15 laptops. Make sure that the laptop is connected to the power outlet. When first booting, system will reboot several times and eventually you will be presented with a boot prompt. Select the top option. user: l2orkist password: l2orkistra! computer name: Austru, Briza, Cyclone, Descuernacabras, Etesian, Fohn, Gale, Hayate, Iuana, Jugo, ... (please check on the laptop bag for the actual name) Time Zone: Type Blacksburg and then select appropriate location from the dropdown Use your own eduroam login (you will erase it later) for software updates and other install stuff. See screenshot for the WiFi settings. Once installed, open the terminal, and run the following commands (one at a time): sudo apt update (enter password and press enter) sudo apt upgrade sudo snap install sublime-text --classic sudo snap install zoom-client sudo apt install qjackctl openssh-server (make sure to enable real-time audio) sudo apt install pipewire-audio-client-libraries libspa-0.2-bluetooth libspa-0.2-jack sudo apt install wireplumber pipewire-media-session- sudo cp /usr/share/doc/pipewire/examples/alsa.conf.d/99-pipewire-default.conf /etc/alsa/conf.d/ sudo cp /usr/share/doc/pipewire/examples/ld.so.conf.d/pipewire-jack-*.conf /etc/ld.so.conf.d/ sudo ldconfig sudo apt remove pulseaudio-module-bluetooth systemctl --user --now enable wireplumber.service gsettings set org.gnome.mutter auto-maximize false (restart the computer, log back in, open terminal, and type the following command) pactl info (look for Server Name: line which should say "Server Name: PulseAudio (on PipeWire 0.3.48)") wget https://l2ork.music.vt.edu/data/pd-l2ork/Pd-L2Ork-full-20231129-rev.64230131-x86_64.deb sudo dpkg -i Pd*deb sudo apt -f install Start qjackctl by typing qjackctl and pressing enter in the terminal, it should show immediately it is running Start pd-l2ork and in preferences set it to settings in the screenshot. Press "Apply" then "OK" ("Apply" is critical before "OK"). If you forgot to do this, reopen preferences and press "Apply", then "OK". In qjackctl open the graph and patch the audio input and output as shown in the screenshot Change qjackctl settings by clicking on the "Setup" button and adjusting the Misc tab as per attached screenshot (enable system try icon and start minimized). Test in pd-l2ork (using Media->Test Audio and Midi) to make sure both input and output are working--make sure that microphone is registering your voice. If it doesn't you have connected the wrong input (there are 2 possible stereo inputs). Fix it in the qjackctl Graph, if necessary. In qjackctl open the Patchbay (see the screenshot), then click on "New", then "Refresh", then "Save", and save it in the /home/l2orkist/ folder as qjackctl-default.xml. Then click on "Activate" button in the top right corner. Close the Patchbay and Graph windows. Quit both qjackctl and pd-l2ork and reopen them to see if everything automatically works. Open terminal and type the following commands (one at a time): wget https://l2ork.music.vt.edu/data/pd-l2ork/L2Ork-Tweeter.zip mv L2Ork-Tweeter.zip ~/Pd-L2Ork/apps/ cd ~/Pd-L2Ork/apps/ unzip L2Ork-Tweeter.zip When prompted whether you should overwrite existing files, press A for All. Once done, close the terminal. Open pd-l2ork and then L2Ork-Tweeter and test if the hover mode works ok. Configure left to have following favorite shortcuts (favorites are above the horizontal line break), by opening the bottom-left menu (9 squares), searching for the app, and then dragging it to the left menu to reflect the exact same order as in the provided screenshot. Click on the top-right corner of the top bar. Select settings. Click on Appearance in the left bar. Select the dark theme. Press Fn+Alt+F2 and type gnome-session-properties. Press enter. Then, as per screenshot, click on "Add", and add qjackctl entry. Log out and back in to see if qjackctl automatically starts (it will be a small icon in the top-right corner next to the WiFi, audio, and battery icon). Copy authorized_keys to the /home/l2orkist/.ssh/ folder (it is invisible, so you will have to manually go to it by typing following inside a file browser ~/.ssh and then pressing enter. Copy L2Ork.zip to the /home/l2orkist folder (your Home folder). Right-click on it and select "Extract Here" option. Once done, delete the L2Ork.zip file. = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = ADDITIONAL STEPS FOR ALL LAPTOPS INCLUDING THOSE THAT HAVE BEEN ALREADY CONFIGURED Next, install supporting tools needed for L2Ork wiimote connectivity by opening a terminal and typing one line at a time (when asked for password, respond with the one listed at the top of this document): sudo apt install net-tools cp ~/L2Ork/PD/Abstractions/l2ork_wii_jolt_filter.pd ~/Pd-L2Ork/apps/L2Ork-Tweeter/l2orkmote/ Now let's make sure we run older kernel to ensure L2Orkmote still works: sudo apt install linux-image-5.19.0-50-generic linux-modules-5.19.0-50-generic linux-modules-extra-5.19.0-50-generic subl & grep submenu /boot/grub/grub.cfg (copy the part in quotes, but without quotes starting with 'gnulinux and ending with the single quote ('), e.g. gnulinux-advanced-35d64158-1ba2-47a0-a0e4-bde8d8a61b71; paste this value into the text editor that opened when you ran subl &; add > at the end of what you pasted, e.g. gnulinux-advanced-35d64158-1ba2-47a0-a0e4-bde8d8a61b71>) grep gnulinux-5.19.0-50-generic-advanced /boot/grub/grub.cfg (copy the 'gnulinux-...' part into the same text editor window where you pasted previous text, e.g. gnulinux-advanced-35d64158-1ba2-47a0-a0e4-bde8d8a61b71>gnulinux-5.19.0-50-generic-advanced-35d64158-1ba2-47a0-a0e4-bde8d8a61b71; NOTE THAT YOUR NUMBERS AND LETTER WILL BE DIFFERENT AND THAT IF YOU MESS THIS UP THE COMPUTER WILL NOT BE ABLE TO BOOT) sudo subl /etc/default/grub (in the newly opened text file look for GRUB_DEFAULT=0 statement and replace it with GRUB_DEFAULT='') (save the /etc/default/grub file with ctrl+s) sudo update-grub (check for any errors) Close the terminal. If this is not your laptop and you have been using your Eduroam internet login, edit the Eduroam connection by replacing your username and password with TODO (this way students will just have to change that aspect). Make sure to save settings. Reboot. Open terminal. uname -a (make sure the printout lists kernel version 5.19.0-50) Close terminal.