CSDOSC

---

1. Introductie
2. Voorbereiding
3. Installatie
   • Mac
   • Windows

Introductie

Tijdens Sysbas gaan we gebruik maken van de programmeertaal Javascript om te leren programmeren. Daarvoor maken we gebruik van de library P5.js, waarmee je makkelijk audio/ visuele programma's kan maken. Dit doen we omdat Javascript redelijk eenvoudig te begrijpen is en je met P5.js snel een zichtbaar en hoorbaar resultaat bereikt.

P5.js is al redelijk makkelijk in gebruik, maar een aantal dingen werken alleen als je je computer op een bepaalde manier configureert en als we uiteindelijk Max en P5.js met elkaar willen laten communiceren, zullen we daar extra software voor nodig hebben. Om hier meteen een goede start mee te maken zodat we de rest van het jaar aan de slag kunnen hebben we software ontwikkeld waarmee dit gemakkelijk kan. Dit is csdosc.
csdosc is een lokale webserver waarmee je webpagina's die je op je computer hebt opgeslagen kan laten zien in de browser. Hieronder vind je een installatie-handleiding. Als je deze stap voor stap doorneemt kan je met csdosc aan de slag. Als je csdosc installeert wordt P5.js automatisch meegeïnstalleerd. Dat hoef je dus niet apart te doen.

---

Voorbereiding

Mappenstructuur

Om goed gebruik te kunnen maken van jouw computer is het noodzakelijk om een heldere mappenstructuur te hebben op je computer. Of je nou met sessies uit je DAW werkt, een grote collectie audio-samples hebt of programma's ontwikkelt. Als je ze niet kan terugvinden, dan heb je er niets aan. Daarom ga je voordat je het programma installeert een mappenstructuur aanmaken waar je de rest van het eerste jaar (en de rest van de opleiding) wat aan hebt. Dit kan in de Finder (MacOs) of Verkenner (Windows).

• Begin met een hoofdmap, plaats deze in je documenten-folder, of op een andere logisch terug te vinden locatie. Noem deze map HKU.
• Plaats vervolgens in deze map een nieuwe map en noem deze jaar1 (gebruik geen spaties, als we later gebruik gaan maken van de Terminal of Command Prompt om door onze computer te navigeren, dan zijn spaties onhandig).
• Vervolgens maak je voor de verschillende vakken mappen aan: sysbas, klaba, muzbas etc.
• In de map sysbas maak je twee mappen aan: max en javascript.

Terminal

We gaan in deze Sysbas-lessen gebruik maken van de Terminal (macOS) of Command Prompt (Windows). Een commando-gebaseerde manier om je computer aan te sturen. Lees om hier goed mee aan de slag te gaan het volgende hoofdstuk uit de syllabus goed door: Terminal

Installatie

Kies hieronder de installatie-handleiding voor het besturingssysteem dat jij gebruikt.

---

MacOS

• Download als .zip via de groene knop Code alle bestanden van github naar je harde schijf en zet deze in de HKU/jaar1/sysbas/javascript-map die je hebt aangemaakt in bovenstaande voorbereiding.
• Als je de bestanden gedownload hebt: pak de .zip-file uit en hernoem de map csdosc-master naar csdosc.
• Download node.js via https://nodejs.org/en/download door te klikken op macOS Installer (.pkg), en installeer dit.
• Zorg dat je het hoofdstuk over de terminal goed gelezen hebt en dat de terminal juist geconfigureerd is.
• Ga in je finder naar de csdosc-map
• Klik met rechtermuisknop (ctrl + click) op install-mac.sh en selecteer Open Met -> Terminal
• Vervolgens zullen alle benodigde bestanden worden geïnstalleerd.
• Als dat allemaal gelukt is krijg je in het terminal-scherm te zien: De server staat aan! Je kunt deze via localhost:8001 bereiken. Je kunt dit programma afsluiten door stop+enter te typen Dit betekent dat het gelukt is.
• Als het niet lukt, vraag het dan in de les aan een van de docenten/ assistenten.

---

Windows

• Download als .zip via de groene knop Code alle bestanden van github naar je harde schijf en zet deze in de HKU/jaar1/sysbas/javascript-map die je hebt aangemaakt in bovenstaande voorbereiding.
• Als je de bestanden gedownload hebt: pak de .zip-file uit en hernoem de map csdosc-master naar csdosc. (dus niet dubbelklikken op de map, maar echt uitpakken)
• Download node.js via https://nodejs.org/en/download door te klikken op Windows Installer (.msi), en installeer dit.
• Ga in de verkenner naar de csdosc-map
• Dubbelclick op install-windows.bat.
• Vervolgens zullen alle benodigde bestanden worden geïnstalleerd.
• Als dat allemaal gelukt is krijg je in het terminal-scherm te zien: De server staat aan! Je kunt deze via localhost:8001 bereiken. Je kunt dit programma afsluiten door stop+enter te typen Dit betekent dat het gelukt is.
• Als het niet lukt, vraag het dan in de les aan een van de docenten/ assistenten.