Restructured documentation.

README.md

@@ -1,32 +1,18 @@
-# falco
+# project Falco
 
-falco - classic chiptune/electronic music instruments implemented with SunVox & Lua scripts
+virtual instrumens and other music resources
 
 > When the technique is primitive, everything is beautiful, and when the technique is perfected, almost everything is ugly.
 > -- Jean Renoir
 
+What's included:
 
-## INSTRUMENTS
+- [drumsheet](drumsheet) - dead simple drum machine
+- `midiwire` - lua wrapper of windows' MIDI interface
+- `sunvoxlua` - lua wrapper of headless [Sunvox](https://www.warmplace.ru/soft/sunvox/)
+- `cabbages` - various instruments and tools developed with [Cabbage framework](https://cabbageaudio.com/)
+- `commented_cabbage` - Cabbage code developed by others and commented by me (for reverse engineering purposes)
+- `misc` - various tests and scratches
 
-- PC Speaker (PLAY command - https://en.wikibooks.org/wiki/QBasic/Appendix#PLAY)
-- SID (https://www.c64-wiki.com/wiki/SID)
-- [Game Boy sound chip](https://aselker.github.io/gameboy-sound-chip/)
-- TB-303, TR-808, DX7
-- Juno 106
-- Gated Snare
-- general drum machine
-- arpegiator
-- autoharph/chord dial
-- [Emulator II Marcato strings](http://madtheory.com/site/famous-samples-part-1-emulator-ii-marcato-strings/) & [other classic samples](http://fanazic.free.fr/)
-
-
-## IDEAS & RESOURCES
-
-- play2wav - https://stackoverflow.com/questions/11355353/how-can-i-convert-qbasic-play-commands-to-something-more-contemporary
-- SID keyboard - https://www.youtube.com/watch?v=RX4JfLCaBMU
-- https://www.synthmania.com/Famous%20Sounds.htm
-- https://reverbmachine.com/blog/exploring-the-yamaha-dx7
-- http://www.giordanobenicchi.it/midi-tech/miditech.htm
-- http://lucasturaro.space/2015/08/28/binding-lua-callbacks-in-c/
-- http://davidhall.io/visualising-music-graphic-scores/
-- https://github.com/olilarkin/awesome-musicdsp
+> They said I was dehumanizing music! My response was - Perhaps it’s the humanization of computers.
+> -- John Chowning

drumsheet/README.md

@@ -2,6 +2,8 @@
 
 dead simple drum machine
 
+![screenshot](drumsheet.png)
+
 ## todo
 
 - tlačítko na vygenerování náhodného patternu (různé algoritmy)

ideas.md

@@ -0,0 +1,14 @@
+# ideas and overall vision
+
+(in Czech only for now, sorry)
+
+- věc musí být snadno pochopitelná, na první pohled musí být vidět, co to dělá
+- všechno musí mít svou grafickou/textovou/zvukovou podobu
+
+## konkrétní nápady
+
+- chordial - formulář na jednoduché zadávání složitých akordů
+- autoharfa - doplňuje akordy při živém hraní ([částečně implementováno](https://www.warmplace.ru/forum/viewtopic.php?f=11&t=4482&p=15727) & ještě někde jinde)
+- [notovid](https://github.com/severak/notovid) - beer grafický zápis, plive MIDI noty
+- drumsheet - drum machine z tabulky v excelu
+

resources.md

@@ -0,0 +1,26 @@
+# resources
+
+## INSTRUMENTS description
+
+- PC Speaker (PLAY command - https://en.wikibooks.org/wiki/QBasic/Appendix#PLAY)
+- SID (https://www.c64-wiki.com/wiki/SID)
+- [Game Boy sound chip](https://aselker.github.io/gameboy-sound-chip/)
+- TB-303, TR-808, DX7
+- Juno 106
+- Gated Snare
+- general drum machine
+- arpegiator
+- autoharph/chord dial
+- [Emulator II Marcato strings](http://madtheory.com/site/famous-samples-part-1-emulator-ii-marcato-strings/) & [other classic samples](http://fanazic.free.fr/)
+
+## LINKS
+
+- play2wav - https://stackoverflow.com/questions/11355353/how-can-i-convert-qbasic-play-commands-to-something-more-contemporary
+- SID keyboard - https://www.youtube.com/watch?v=RX4JfLCaBMU
+- https://www.synthmania.com/Famous%20Sounds.htm
+- https://reverbmachine.com/blog/exploring-the-yamaha-dx7
+- http://www.giordanobenicchi.it/midi-tech/miditech.htm
+- http://lucasturaro.space/2015/08/28/binding-lua-callbacks-in-c/
+- http://davidhall.io/visualising-music-graphic-scores/
+- https://github.com/olilarkin/awesome-musicdsp
+- https://llllllll.co/t/experimental-music-notation-resources/149/420