<palign="center">CssLsd is a Chromium Extension which allows for interactively modifying
<palign="center">CssLsd is a Chromium Extension which allows for interactively modifying the style of web pages using MIDI messages, Keyboard presses or Audio input features.</p>
the style of web pages using MIDI messages, Keyboard presses or Audio input
@@ -1401,24 +1429,16 @@ Pin the extension to get it close to URL bar. CLick on CSSLSD logo to open it.</
...
@@ -1401,24 +1429,16 @@ Pin the extension to get it close to URL bar. CLick on CSSLSD logo to open it.</
Open devtool, in "element", "source", "console" bar click on view more arrow, then drag-and-drop "CSSLSD" button.
Open devtool, in "element", "source", "console" bar click on view more arrow, then drag-and-drop "CSSLSD" button.
You can put "element" tab to bottom by right-clicking on it.
You can put "element" tab to bottom by right-clicking on it.
For deported devtool, click on more (top-right) and then click on separate devtool dock.</p>
For deported devtool, click on more (top-right) and then click on separate devtool dock.</p>
<h4id="start-to-use-functionnalities">Start to use functionnalities</h4>
<p>Click on activate button, right top. When it becomes green you can click on audio one. If audio well started it's become green too. Don't forget to authorize the tab to get access to your microphone.</p>
<h5id="midi">MIDI</h5>
<p>Click on activate button, then on MIDI button. If this one becomes green, the MIDI is operationnal to use. Your device is displayed on top left. On control change on your MIDI device and if the extension pop-up is open the control ID will be displayed on top center. And if you focus text MIDI column parameter, control will be add to the list.</p>
<h5id="loops">Loops</h5>
<p>When you press record all interactions with the midi device are recorded in a table. When finished recording, press stop. You can then play your loop by pressing play or re-record over the previously created loop. Finally, you can overwrite the created loop. You have 4 slots available to save your loops. You can also map MIDI events to the actions listed above.
You can't record simultaneously loops, push on record N°X button will overwrite the loop N°X.</p>
<h4id="upload-and-download">Upload and download</h4>
<p>You have the possibility to export all CSS-LSD settings and codes as a JSON file. You can then import a previously exported JSON file from the extension. This can be useful for saving presets according to websites.</p>
<h3id="csslsd-code">CSSLSD Code</h3>
<h3id="csslsd-code">CSSLSD Code</h3>
<p>You need to use a custom CSS template, like below to map your audio or MIDI events to some CSSLSD properties. All parameters are between square brackets you can extend parameter by heritage with a range (this is not mandatory).</p>
<p>You need to use a custom CSS template, like below to map your audio or MIDI events to some CSSLSD properties. All parameters are between <strong>square brackets</strong> you can extend parameter by heritage with a range like bellow (this is not mandatory). You can use multiple parameters in a line. You can also type pure CSS in code editor, this CSS wil be apply on code auto-save (each time your type something in editor).</p>
<spanclass="hljs-comment">/* Tip : You can use comments */</span>
<spanclass="hljs-comment">/* Here, we map "couleur" parameter to background-color property extended with a new range between black (hex) and white (hex). */</span>
<p>Click on activate button, right top. When it becomes green you can click on audio one. If audio well started it's become green too. Don't forget to authorize the tab to get access to your microphone.</p>
<h4id="midi">MIDI</h4>
<p>Click on activate button, then on MIDI button. If this one becomes green, the MIDI is operationnal to use. Your device is displayed on top left. On control change on your MIDI device and if the extension pop-up is open the control ID will be displayed on top center. And if you focus text MIDI column parameter, control will be add to the list.</p>
<h3id="loops">Loops</h3>
<p>When you press record all interactions with the midi device are recorded in a table. When finished recording, press stop. You can then play your loop by pressing play or re-record over the previously created loop. Finally, you can overwrite the created loop. You have 4 slots available to save your loops. You can also map MIDI events to the actions listed above.
You can't record simultaneously loops, push on record N°X button will overwrite the loop N°X.</p>
<h3id="upload-and-download">Upload and download</h3>
<p>You have the possibility to export all CSS-LSD settings and codes as a JSON file. You can then import a previously exported JSON file from the extension. This can be useful for saving presets according to websites.</p>
<palign="center">CssLsd is a Chromium Extension which allows for interactively modifying
<palign="center">CssLsd is a Chromium Extension which allows for interactively modifying the style of web pages using MIDI messages, Keyboard presses or Audio input features.</p>
the style of web pages using MIDI messages, Keyboard presses or Audio input
-[Start to use functionnalities](#start-to-use-functionnalities)
-[Start to use functionnalities](#start-to-use-functionnalities)
-[Audio](#audio)
-[Audio](#audio)
-[MIDI](#midi)
-[MIDI](#midi)
-[Loops](#loops)
-[Loops](#loops)
-[Upload and download](#upload-and-download)
-[Upload and download](#upload-and-download)
-[CSSLSD Code](#csslsd-code)
-[MIDI Variables](#midi-variables)
-[Audio Variables](#audio-variables)
-[Types](#types)
-[Options](#options)
-[Examples](#examples)
-[Examples](#examples)
-[Ressources](#ressources)
-[Ressources](#ressources)
## Setup
## Setup
- Download or Clone CssLsd
- Download or Clone CssLsd
- Start Chromium
- Start Chromium / Chrome / Brave / Edge
- Type chrome://extensions in the address bar
- Type `chrome://extensions` in the address bar
- Click "Load unpacked extension" and select the csslsd folder
- Click "Load unpacked extension" and select the csslsd folder
- Now the extension should appear in the menu bar
- Now the extension should appear in the menu bar
### Browser comatibility for AudioWorklet
### Browser compatibility
#### AudioWorklet (audio sound analyzer)
| Chrome | Edge | Firefox | Opéra | Brave |
| Chrome | Edge | Firefox | Opéra | Brave |
|--------|------|---------|-------|-------|
|--------|------|---------|-------|-------|
| 64 | 79 | 76 | 51 | 64 |
| 64 | 79 | 76 | 51 | 64 |
#### MIDI API
| Chrome | Edge | Firefox | Opéra | Brave |
|--------|------|---------|-------|-------|
| 43 | 79 | NO | 30 | 43 |
## Usage
## Usage
### User Interface
### User Interface
...
@@ -59,38 +67,20 @@ Open devtool, in "element", "source", "console" bar click on view more arrow, th
...
@@ -59,38 +67,20 @@ Open devtool, in "element", "source", "console" bar click on view more arrow, th
You can put "element" tab to bottom by right-clicking on it.
You can put "element" tab to bottom by right-clicking on it.
For deported devtool, click on more (top-right) and then click on separate devtool dock.
For deported devtool, click on more (top-right) and then click on separate devtool dock.
#### Start to use functionnalities
##### Audio
Click on activate button, right top. When it becomes green you can click on audio one. If audio well started it's become green too. Don't forget to authorize the tab to get access to your microphone.
##### MIDI
Click on activate button, then on MIDI button. If this one becomes green, the MIDI is operationnal to use. Your device is displayed on top left. On control change on your MIDI device and if the extension pop-up is open the control ID will be displayed on top center. And if you focus text MIDI column parameter, control will be add to the list.
##### Loops
When you press record all interactions with the midi device are recorded in a table. When finished recording, press stop. You can then play your loop by pressing play or re-record over the previously created loop. Finally, you can overwrite the created loop. You have 4 slots available to save your loops. You can also map MIDI events to the actions listed above.
You can't record simultaneously loops, push on record N°X button will overwrite the loop N°X.
#### Upload and download
You have the possibility to export all CSS-LSD settings and codes as a JSON file. You can then import a previously exported JSON file from the extension. This can be useful for saving presets according to websites.
### CSSLSD Code
### CSSLSD Code
You need to use a custom CSS template, like below to map your audio or MIDI events to some CSSLSD properties. All parameters are between square brackets you can extend parameter by heritage with a range (this is not mandatory).
You need to use a custom CSS template, like below to map your audio or MIDI events to some CSSLSD properties. All parameters are between **square brackets** you can extend parameter by heritage with a range like bellow (this is not mandatory). You can use multiple parameters in a line. You can also type pure CSS in code editor, this CSS wil be apply on code auto-save (each time your type something in editor).
Code example:
Code example:
```css
```css
body{
body{
/* Tip : You can use comments */
/* Here, we map "couleur" parameter to background-color property extended with a new range between black (hex) and white (hex). */
background-color:[couleur#000:#fff];
background-color:[couleur#000:#fff];
}
}
h1{
h1{
/* Simple parameter usage */
opacity:[opacité];
opacity:[opacité];
}
}
```
```
...
@@ -139,7 +129,28 @@ To ***save*** your template, it's automatic ! Just type, edit what you want. It
...
@@ -139,7 +129,28 @@ To ***save*** your template, it's automatic ! Just type, edit what you want. It
| i:1 | Incremental value between type object, increment can be negative|
| i:1 | Incremental value between type object, increment can be negative|
| d | Linear value between type object |
| d | Linear value between type object |
### Examples
### Start to use functionnalities
#### Audio
Click on activate button, right top. When it becomes green you can click on audio one. If audio well started it's become green too. Don't forget to authorize the tab to get access to your microphone.
#### MIDI
Click on activate button, then on MIDI button. If this one becomes green, the MIDI is operationnal to use. Your device is displayed on top left. On control change on your MIDI device and if the extension pop-up is open the control ID will be displayed on top center. And if you focus text MIDI column parameter, control will be add to the list.
### Loops
When you press record all interactions with the midi device are recorded in a table. When finished recording, press stop. You can then play your loop by pressing play or re-record over the previously created loop. Finally, you can overwrite the created loop. You have 4 slots available to save your loops. You can also map MIDI events to the actions listed above.
You can't record simultaneously loops, push on record N°X button will overwrite the loop N°X.
### Upload and download
You have the possibility to export all CSS-LSD settings and codes as a JSON file. You can then import a previously exported JSON file from the extension. This can be useful for saving presets according to websites.
