Commit 686f0624 authored by Jérôme Abel's avatar Jérôme Abel

delete software, update hardware, create readme

parent d50d1823

Too many changes to show.

To preserve performance only 1000 of 1000+ files are displayed.

# BrutBox
The BrutBox is an open source midi device based on a Teensy microcontroller. The software is based on Pure Data and our [Malinette](http://malinette.info) project. You should follow this link to install it.
Website: http://reso-nance.org/brutbox
Documentation: http://reso-nance.org/wiki/projets/brutbox/accueil
This diff is collapsed.
This diff is collapsed.
# La Malinette
A Free Open Source Kit To Simplify Programming Interactivity
- Version: 0.90.beta1
- Languages: English, French
- Date: 15/10/2015
- Contact: contact_at_reso-nance.org
- Website: http://reso-nance.org/malinette
- Licence: GNU/GPL v3
Special thanks for all Pure Data developers, we've taken some good ideas from few projects (pdmtl abstractions, DIY2, ...)
## Description
Malinette is an all-in-one solution, a rapid prototyping tool to show and make simple interaction and multimedia projects. It is a software and a hardware set. The software is based on Pure Data extended. It is also a very convenient suitcase and wood boxes with sensors, actuators, Arduino, Teensy and electronic components to test ideas and projects very quickly.
## Features
See : http://reso-nance.org/malinette/en/software/features
## Requirements
- Computer : a decent computer (>2005 is adviced)
- Operating system : should work on Mac OS X, MS Windows and main GNU/Linux distributions.
- Install Pd-extended : http://puredata.info/downloads/pd-extended
- Optional, if you want to use an Arduino, download the Arduino software : http://www.arduino.cc/en/Main/Software. Plug the USB board, install drivers if required, and upload the "StandardFirmata" sketch from the Arduino software : Menu File > Examples > Firmata > StandardFirmata
## Pure Data dependancies
If you have not Pure Data Extended, here you can find our dependancies : initbang, Gem, zexy, cyclone, moonlib, moocow, hcs, tof, comport, iemlib, iemnet or oscx or mrpeach, motex, ggee, list-abs, mapping
## Installation and startup
1. Download the software:
- The most recent version : https://git.framasoft.org/resonance/malinette
- Release : http://reso-nance.org/malinette/en/download
2. Extract anywhere
3. Open the "MALINETTE.pd"
4. Open Manual examples to see how it works
## User instructions
You have two windows : the menu on the left and the project window on the right (called a "patch" in Pure Data). Basically, you can open examples or create your project. When you want to start a project, the better way is to open the "new" project and fill it with some objects. Clic on the "?" buttons to find all objects of a category. You can also find some documentations in the "./docs" folder.
Have fun and report feedbacks and bugs at contact_/at/_reso-nance.org.
## Content
- ./abstractions : all objects (audio, core, in, numbers, out, seq, video)
- ./medias : media files (images, videos, sounds, etc.)
- ./docs : some documentations (license, todo, changes) and OVERVIEW.pdf help
- ./examples : examples patchs to show and edit projects about interaction
- ./other : tclplugins, scripts, processing codes, ...
- ./projects : your projects folders
- MALINETTE.pd : open this patch to start the program (in french)
- preferences.txt : preferences file with global setup (language, level, screen size, project folder)
- README.md
## Abstractions
- ./abstractions/audio : audio effects
- ./abstractions/core : core functions (menu buttons, media masters, tools, ...)
- ./abstractions/in : inputs (arduino, audio, video, mouse, key, kinect, ...)
- ./abstractions/numbers : numbers effects
- ./abstractions/out : outputs (arduino, audio, video, ...)
- ./abstractions/seq : sequencers tools
- ./abstractions/video : video effects
## Coding rules
- file names with dash
- file names in lowercase
- default values
- test arguments
- a toggle to switch on/off the abstraction
- when an extra object is used from pd-extended, put the library as a prefix. Ex: [tof/menubutton] (to discuss)
- if they are more than 2 or 3 inlets, a good practice would be to use the cold inlet (on the right) to pass messages throught it and route them with a [route] object.
## Files formats (video, audio, 3d etc..)
Video : best format for video files (better performance in pd) is MJPEG, this compression is better packed in .avi for windows and .mov for mac.
Audio : Pure Data audio objects use .aiff or .wav, except some librairies which use mp3 (we do not have mp3 player yet).
3d: .obj is the 3d-model-file you can import in Pure Data, you can create .obj from most of 3D software (like Blender for instance).
## Some documentations (in french)
- Pure Data : http://fr.flossmanuals.net/Puredata/
- Arduino : http://fr.flossmanuals.net/arduino/
- Forum de bidouilleurs : http://codelab.fr/
#N canvas 346 82 531 285 10;
#X declare -path ../core;
#X obj 252 162 arduino-out;
#X obj 252 112 midi-out;
#X obj 14 34 cnv 15 140 20 empty empty VIDEO 20 11 0 14 -179879 -1
0;
#X obj 175 34 cnv 15 58 20 empty empty AUDIO 10 11 0 14 -179879 -1
0;
#X obj 254 34 cnv 15 185 20 empty empty DATA 10 11 0 14 -179879 -1
0;
#X text 441 157 [arduino-out];
#X obj 253 65 osc-out;
#X obj 175 65 audio-out;
#X obj 14 162 video-out;
#N canvas 487 408 450 300 _COLORS_ 0;
#X msg 131 21 1 131 255 0 22;
#X msg 124 -2 5 255 237 2 22;
#X msg 111 -19 255 159 20 28 0;
#X obj 111 42 gui ../out;
#X msg 102 -44 157 235 176 12 22;
#X obj 109 160 declare -path ../core;
#X obj 240 128 outlet;
#X obj 322 36 r CNV-out;
#X msg 278 -19 102 255 110 12 22;
#X connect 0 0 3 0;
#X connect 1 0 3 0;
#X connect 2 0 3 0;
#X connect 3 0 6 0;
#X connect 4 0 3 0;
#X restore 429 63 pd _COLORS_;
#X obj 429 86 universal 1;
#X obj 370 11 ../include;
#X obj 14 65 video-object;
#X obj 14 115 video-text;
#X obj 13 212 video-graph;
#X connect 9 0 10 0;
#N canvas 843 62 1072 821 10;
#X declare -path ../../abstractions/in -path ../../abstractions/out
-path ../../abstractions/numbers -path ../../abstractions/video -path
../../abstractions/audio -path ../../abstractions/core -path ../../abstractions/seq
;
#X obj 521 -41 ../../abstractions/include;
#X obj 201 80 cnv 25 138 39 empty empty empty 3 6 1 10 -241339 -1 0
;
#X obj 201 69 cnv 12 138 19 \$0-cnv-presetnb \$0-presetnb-in 9 24 9
1 10 -228856 -1 0;
#X obj 243 71 bng 16 250 50 0 \$0-plus empty > 4 5 1 9 -262144 -1 -1
;
#X obj 202 71 bng 16 250 50 0 \$0-moins empty < 4 5 1 9 -262144 -1
-1;
#X obj 243 71 cnv 16 16 16 empty empty > 6 7 1 9 -86277 -262144 0;
#X obj 202 71 cnv 16 16 16 empty empty < 6 7 1 9 -86277 -262144 0;
#X obj 263 70 cnv 14 20 14 \$0-cnv-preset \$0-cnv-preset-in Hithat-closed
3 8 1 12 -228856 -1 0;
#N canvas 1531 109 312 459 SELECT 0;
#X obj 75 364 % 16;
#X obj 75 335 f;
#X obj 99 335 + 1;
#X obj 82 67 r \$0-plus;
#X obj 48 47 r \$0-moins;
#X msg 82 107 1;
#X msg 48 107 -1;
#X obj 75 146 t b b f;
#X obj 146 110 initbang;
#X obj 204 112 loadbang;
#X obj 146 190 pipe 10;
#X text 41 15 selecteurs +/- de preset;
#X text 180 158 preset argu nommage;
#X obj 157 144 f \$1;
#X obj 75 397 s \$0-newpreset;
#X obj 21 326 nbx 5 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10
-262144 -1 -1 0 256;
#X connect 0 0 14 0;
#X connect 1 0 2 0;
#X connect 1 0 0 0;
#X connect 2 0 1 1;
#X connect 3 0 5 0;
#X connect 4 0 6 0;
#X connect 5 0 7 0;
#X connect 6 0 7 0;
#X connect 7 0 1 0;
#X connect 7 1 2 0;
#X connect 7 2 2 1;
#X connect 8 0 13 0;
#X connect 9 0 13 0;
#X connect 10 0 1 0;
#X connect 13 0 10 0;
#X connect 15 0 14 0;
#X restore 512 -17 pd SELECT;
#N canvas 1329 127 1147 654 PRESETS 0;
#X obj 781 229 s \$0-presets;
#X obj 808 117 r \$0-newpreset;
#X obj 781 195 route list;
#X obj 563 535 pack s \$0;
#X obj 478 407 unpack f s f f f f f f f f f f f f f f;
#X msg 563 564 \; \$2-cnv-preset-in label \$1;
#X obj 474 375 r \$0-presets;
#X obj 438 597 pack s \$0;
#X msg 438 626 \; \$2-presetnb-in label \$1;
#X obj 438 571 makefilename %d;
#X obj 426 529 nbx 5 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10
-262144 -1 -1 9 256;
#X obj 780 157 ../numbers/mem synth-drumsampler.txt;
#X connect 1 0 11 0;
#X connect 2 0 0 0;
#X connect 3 0 5 0;
#X connect 4 0 10 0;
#X connect 4 1 3 0;
#X connect 6 0 4 0;
#X connect 7 0 8 0;
#X connect 9 0 7 0;
#X connect 10 0 9 0;
#X connect 11 0 2 0;
#X restore 513 3 pd PRESETS;
#X obj 203 89 hsl 135 20 0.01 1 0 0 \$0-note \$0-notein NOTE 5 11 1
10 -33289 -228856 -99865 13400 0;
#X obj 264 270 fade 100;
#X obj 266 134 inlet note;
#X obj 266 158 s \$0-notein;
#X obj 102 291 cnv 15 400 170 empty empty empty 20 12 0 14 -261682
-66577 0;
#X obj 201 300 r tempere;
#X obj 201 327 + 1;
#X obj 231 344 gate 2;
#X obj 264 370 notescale;
#X obj 295 324 r gamme-master;
#X obj 326 347 r fondamentale-master;
#X obj 134 299 initbang;
#X msg 134 325 0;
#X msg 271 493 pitch \$1;
#X obj 45 139 inlet;