KXStudio
/
Website
mirror of https://github.com/KXStudio/Website
1
0
Fork 0
Code Releases 0 Activity
Browse Source

Add root php code

pull/1/head
falkTX 11 years ago
parent
72e593819c
commit
556236f596
48 changed files with 4794 additions and 0 deletions
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. +325
    -0
      Applications.php
  2. +84
    -0
      Applications:Cadence-JackMeter.php
  3. +93
    -0
      Applications:Cadence-JackSettings.php
  4. +82
    -0
      Applications:Cadence-Logs.php
  5. +111
    -0
      Applications:Cadence-Render.php
  6. +93
    -0
      Applications:Cadence-XYController.php
  7. +85
    -0
      Applications:Cadence.php
  8. +60
    -0
      Applications:Carla-Control.php
  9. +132
    -0
      Applications:Carla.php
  10. +95
    -0
      Applications:Catarina.php
  11. +59
    -0
      Applications:Catia.php
  12. +48
    -0
      Applications:Claudia-Launcher.php
  13. +57
    -0
      Applications:Claudia.php
  14. +84
    -0
      Artwork.php
  15. +43
    -0
      Development.php
  16. +36
    -0
      Development:TODO.php
  17. +77
    -0
      Documentation.php
  18. +84
    -0
      Documentation:KXStudio12041:NetBootInstall.php
  19. +54
    -0
      Documentation:KXStudio12041:ReleaseNotes.php
  20. +46
    -0
      Documentation:KXStudio12043:ReleaseNotes.php
  21. +146
    -0
      Documentation:Manual:alsa_and_kxstudio.php
  22. +150
    -0
      Documentation:Manual:cadence_introduction.php
  23. +77
    -0
      Documentation:Manual:downloading_and_booting_kxstudio.php
  24. +160
    -0
      Documentation:Manual:included_and_recommended_apps.php
  25. +162
    -0
      Documentation:Manual:installing_kxstudio.php
  26. +106
    -0
      Documentation:Manual:jack_configuration.php
  27. +118
    -0
      Documentation:Manual:kxstudio_and_free_software.php
  28. +65
    -0
      Documentation:Manual:kxstudio_introduction.php
  29. +128
    -0
      Documentation:Manual:latency.php
  30. +67
    -0
      Documentation:Manual:linux_audio_overview.php
  31. +161
    -0
      Documentation:Manual:package_management.php
  32. +92
    -0
      Documentation:Manual:simple_claudia_studio.php
  33. +232
    -0
      Documentation:Manual:useful_links_and_getting_help.php
  34. +87
    -0
      Documentation:Manual:video_drivers.php
  35. +117
    -0
      Documentation:Manual:wineasio_and_reaper.php
  36. +68
    -0
      Documentation:Ubuntu:Meta-Packages.php
  37. +34
    -0
      Documentation:Ubuntu:RegisterCommercial.php
  38. +154
    -0
      Documentation:Ubuntu:Upgrade.php
  39. +13
    -0
      Documentation:Wiki.php
  40. +63
    -0
      Donations.php
  41. +32
    -0
      DownloadForced.php
  42. +249
    -0
      Downloads.php
  43. +193
    -0
      News.php
  44. +80
    -0
      Plugins.php
  45. +81
    -0
      Repositories.php
  46. +106
    -0
      Repositories:Applications.php
  47. +39
    -0
      Repositories:Plugins.php
  48. +66
    -0
      index.php

+ 325
- 0
Applications.php View File

@@ -0,0 +1,325 @@
<?php
$PAGE_TITLE = "KXStudio : Applications";
$PAGE_TYPE = "KXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Applications");
$PAGE_SOURCE_2 = ARRAY("Applications");
include_once("includes/header.php");
?>

<!--
TODO: carla-control icon
-->

<div class="box box-description">
<p>
This section lists the applications made by the KXStudio Team.<br/>
You might also want to check:
</p>
<ul>
<li><a href="<?php echo $ROOT; ?>/Repositories:Applications">Applications in the repositories</a></li>
</ul>
<br/>
</div>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Cadence#Interface">
<img src="screenshots/thumb/cadence.png" alt="cadence" class="img_thumb_150"/>
</a></p>
<p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_cadence.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Cadence">Cadence</a></b><br/>
Cadence is a set of tools useful for audio production.<br/>
This is the main app. It performs system checks, manages JACK, calls other tools and make system tweaks.<br/>
<i>(Most of the tools below are part of the Cadence suite)</i>.
<br/><br/><br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Cadence-JackMeter#Interface">
<img src="screenshots/thumb/cadence-jackmeter.png" alt="cadence-jackmeter" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
<!-- <img src="images/ico_mac.png" alt=""/> -->
<img src="images/ico_windows.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_cadence.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Cadence-JackMeter">Cadence-JackMeter</a></b><br/>
Cadence-JackMeter is a digital peak meter for JACK.<br/>
It automatically connects itself to all application JACK output ports that are also connected to the system output.<br/>
<br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Cadence-JackSettings#Interface">
<img src="screenshots/thumb/cadence-jacksettings.png" alt="cadence-jacksettings" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_cadence.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Cadence-JackSettings">Cadence-JackSettings</a></b><br/>
Cadence-JackSettings is a simple and easy-to-use configure dialog for jackdbus.<br/>
It can configure JACK's driver and engine parameters, and it also supports LADISH studios.<br/>
<br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Cadence-Logs#Interface">
<img src="screenshots/thumb/cadence-logs.png" alt="cadence-logs" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_cadence.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Cadence-Logs">Cadence-Logs</a></b><br/>
Cadence-Logs is a small tool that shows JACK, A2J, LASH and LADISH logs in a multi-tab window.<br/>
This is very similar to the the 'ladilog' app but here the logs are viewed in a text box, making it easy to browse and extract status messages using copy and paste commands.<br/>
<br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Cadence-Render#Interface">
<img src="screenshots/thumb/cadence-render.png" alt="cadence-render" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_cadence.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Cadence-Render">Cadence-Render</a></b><br/>
Cadence-Render is a tool to record (or 'render') a JACK project using jack-capture, controlled by JACK Transport.<br/>
It supports a vast number of file types and can render in both realtime and freewheel modes.<br/>
<br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Cadence-XYController#Interface">
<img src="screenshots/thumb/cadence-xycontroller.png" alt="cadence-xycontroller" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
<!-- <img src="images/ico_mac.png" alt=""/> -->
<img src="images/ico_windows.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_cadence.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Cadence-XYController">Cadence-XY Controller</a></b><br/>
Cadence-XY Controller is a simple XY widget that sends and receives data from Jack MIDI.<br/>
It can send data through specific channels and has a MIDI Keyboard too.<br/>
<br/><br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Catarina#Interface">
<img src="screenshots/thumb/catarina.png" alt="catarina" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
<!-- <img src="images/ico_mac.png" alt=""/> -->
<img src="images/ico_windows.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_catarina.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Catarina">Catarina</a></b><br/>
Catarina is a Patchbay test app, created while the PatchCanvas module was being developed.<br/>
It allows the user to experiment with the patchbay, without using ALSA, JACK or LADISH.<br/>
You can save &amp; load patchbay configurations too.<br/>
<br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Catia#Interface">
<img src="screenshots/thumb/catia.png" alt="catia" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
<!-- <img src="images/ico_mac.png" alt=""/> -->
<img src="images/ico_windows.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_catia.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Catia">Catia</a></b><br/>
Catia is a JACK Patchbay, with some neat features like A2J bridge support and JACK Transport.<br/>
It's supposed to be as simple as possible (there's
<a href="<?php echo $ROOT; ?>/Applications:Claudia">Claudia</a> for advanced things),
so it can work nicely on non-Linux platforms.<br/>
<br/>
<br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Claudia#Interface">
<img src="screenshots/thumb/claudia.png" alt="claudia" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_claudia.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Claudia">Claudia</a></b><br/>
Claudia is a LADISH frontend; it's just like Catia, but focused at session management through LADISH.<br/>
It has a bit more features than the official LADISH GUI, with a nice preview of the main canvas in the bottom-left.<br/>
It also implements the 'Claudia-Launcher' add-application style for LADISH.<br/>
<br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Claudia-Launcher#Interface">
<img src="screenshots/thumb/claudia-launcher.png" alt="claudia-launcher" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_claudia-launcher.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Claudia-Launcher">Claudia-Launcher</a></b><br/>
Claudia-Launcher is a multimedia application launcher with LADISH support.<br/>
It searches for installed packages (not binaries), and displays the respective content as a launcher.<br/>
The content is got through an hardcoded database, created and/or modified to suit the target distribution.<br/>
<br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Carla#Interface">
<img src="screenshots/thumb/carla.png" alt="carla" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
<!-- <img src="images/ico_mac.png" alt=""/> -->
<img src="images/ico_windows.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_carla.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Carla">Carla</a></b><br/>
Carla is an audio plugin host, with support for many audio drivers and plugin formats.<br/>
It has some nice features like automation of parameters via MIDI CC and full OSC control.<br/>
Currently supports LADSPA, DSSI, LV2, and VST plugin formats, and GIG, SF2 and SFZ sounds banks.<br/>
<br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/Applications:Carla-Control#Interface">
<img src="screenshots/thumb/carla.png" alt="carla-control" class="img_thumb_150"/></p>
</a><p>
<img src="images/ico_arch.png" alt=""/>
<img src="images/ico_debian.png" alt=""/>
<img src="images/ico_ubuntu.png" alt=""/>
<img src="images/ico_linux.png" alt=""/>
</p>
</td><td>
<p>
<img src="images/ico_carla.png" class="img_text_align" alt=""/>
<b><a href="<?php echo $ROOT; ?>/Applications:Carla-Control">Carla-Control</a></b><br/>
TODO.<br/>
<br/>
</p>
</td></tr>
</table>

<hr/>

<h5><span class="mw-headline">What do those little icons mean?</span></h5>

<table>
<tr>
<td align="right"><img src="images/ico_arch.png" alt=""/> - </td>
<td>Supports ArchLinux (Available in <a href="https://aur.archlinux.org" class="external text" rel="nofollow" target="_blank">AUR</a>)</td>
</tr><tr>
<td align="right"><img src="images/ico_debian.png" alt=""/> - </td>
<td>Supports Debian (Available at the <a href="<?php echo $ROOT; ?>/Repositories#Debian">KXStudio Repositories</a>)</td>
</tr><tr>
<td align="right"><img src="images/ico_ubuntu.png" alt=""/> - </td>
<td>Supports Ubuntu (Available at the <a href="<?php echo $ROOT; ?>/Repositories#Ubuntu">KXStudio Repositories</a>)</td>
</tr><tr>
<td align="right"><img src="images/ico_linux.png" alt=""/> - </td>
<td>Supports all GNU/Linux systems in general (Binaries and Source Code available in the <a href="<?php echo $ROOT; ?>/Downloads">Downloads</a> page)</td>
</tr><tr>
<td align="right"><img src="images/ico_mac.png" alt=""/> - </td>
<td>Supports Mac OS (Package available in the <a href="<?php echo $ROOT; ?>/Downloads">Downloads</a> page)</td>
</tr><tr>
<td align="right"><img src="images/ico_windows.png" alt=""/> - </td>
<td>Supports Windows (Binaries available in the <a href="<?php echo $ROOT; ?>/Downloads">Downloads</a> page)</td>
</tr>
</table>

<hr/>

<p></p>

<?php
include_once("includes/footer.php");
?>

+ 84
- 0
Applications:Cadence-JackMeter.php View File

@@ -0,0 +1,84 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Cadence-JackMeter";
$PAGE_TYPE = "APPLICATION";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Cadence-JackMeter");
$PAGE_SOURCE_2 = ARRAY("Applications", "Cadence-JackMeter");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
Cadence-JackMeter is a digital peak meter for JACK.<br/>
It automatically connects itself to all application JACK output ports that are also connected to the system output.
</p>
<p>
This tool can be executed as 'cadence-jackmeter' for monitoring outputs or 'cadence-jackmeter -in' for monitoring inputs.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
A screenshot follows:<br/>
<a href="screenshots/cadence-jackmeter.png" class="external text" rel="nofollow"><img src="screenshots/cadence-jackmeter.png" alt="cadence-jackmeter.png" /></a>
</p>
<p>
This is a regular digital-audio peak meter as you probably have seen many times before.<br/>
Note that the peak values are based on programming data (0.0 &lt;-&gt; 1.0) and not dB.
</p>
<p>
The meter has small lines to guide you. The value of these lines are (from bottom to top):
</p>
<ul>
<li>0.30%</li>
<li>0.50%</li>
<li>0.70%</li>
<li>0.83%</li>
<li>0.90%</li>
<li>0.96%</li>
</ul>

<!-- Usage -->
<h3><span class="mw-headline" id="Usage"> Usage </span></h3>
<p>
Simply run it and it will automatically connect to all JACK audio ports currently outputting sound to the 'system' client (or inputs if using '-in' argument).<br/>
The JACK client name is 'M' for "meter". When you change connections in the JACK graph, Cadence-JackMeter will change accordingly.
</p>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Cadence-JackMeter is available in the KXStudio repositories and ArchLinux AUR ('cadence-tools' package in the KXStudio repositories, 'cadence' in AUR).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/cadence/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://cadence-tools" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux and Windows (part of the Cadence bundle).<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-win32.zip/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Windows 32bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 93
- 0
Applications:Cadence-JackSettings.php View File

@@ -0,0 +1,93 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Cadence-JackSettings";
$PAGE_TYPE = "APPLICATION";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Cadence-JackSettings");
$PAGE_SOURCE_2 = ARRAY("Applications", "Cadence-JackSettings");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
Cadence-JackSettings is a simple and easy-to-use configure dialog for jackdbus (either JACK2 or JACK1 + DBus patch).<br/>
It can configure JACK's driver and engine parameters (network not yet implemented), and it also supports LADISH studios.
</p>
<p>
This tool can be executed as 'cadence_jacksettings' or from within <a href="<?php echo $ROOT; ?>/Applications:Cadence">Cadence</a>,
<a href="<?php echo $ROOT; ?>/Applications:Catia">Catia</a> and <a href="<?php echo $ROOT; ?>/Applications:Claudia">Claudia</a>.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
A screenshot of the first, "Engine" tab:<br/>
<a href="screenshots/cadence-jacksettings1.png" class="external text" rel="nofollow"><img src="screenshots/cadence-jacksettings1.png" alt="cadence-jacksettings1.png" /></a>
</p>
<p>
A screenshot of the second, "Driver" tab:<br/>
<a href="screenshots/cadence-jacksettings2.png" class="external text" rel="nofollow"><img src="screenshots/cadence-jacksettings2.png" alt="cadence-jacksettings2.png" /></a>
</p>
<p>
The third tab, "Network", is not implemented yet.
</p>
<p>
You probably recognize some options from other JACK configure tools such as QjackCtl.<br/>
They are similar because they manage the same thing (JACK). The difference is mostly at the layout level — that is, how things are organized in the GUI.
</p>
<p>
Most options have a tooltip to help. The 'driver' option (table on the left in the 2nd screenshot) will trigger small changes on the layout.<br/>
NOTE: Leaving a particular driver selected after closing the tool will result in that driver being used the next time JACK starts.
</p>

<!-- Usage -->
<h3><span class="mw-headline" id="Usage"> Usage </span></h3>
<p>
The options will be available (or not) according to your JACK version.<br/>
JACK1 and JACK2 options are different, so Cadence-JackSettings interface will change for them. Some set-ups might also have LADISH specific options.<br/>
<i>(For this first release Cadence-JackSettings is targeted at JACK2 and some minor JACK1 options will be missing)</i>.
</p>
<p>
If you want a more in-depth explanation of what each option does, you can checkout your 'jackd' manual page or view it online <a href="http://trac.jackaudio.org/wiki/jackd%281%29" class="external text" rel="nofollow" target="_blank">here</a>.<br/>
The first part of that manual relates to the 'Engine' options, then specific driver ones.<br/>
Remember that Cadence-JackSettings doesn't really uses 'jackd', but since we are both targeting JACK the options are the same.
</p>
<p>
NOTE: The settings are shared across jackdbus-capable applications (jack_control and ladiconf), but not QjackCtl.<br/>
QjackCtl doesn't support querying and storing settings via jackdbus (it uses its own internal settings), so any change in it will not affect Cadence-JackSettings and vice-versa.<br/>
We recommend using only Cadence and avoid (or uninstall) QjackCtl.
</p>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Cadence-JackSettings is available in the KXStudio repositories and ArchLinux AUR ('cadence-tools' package in the KXStudio repositories, 'cadence' in AUR).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/cadence/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://cadence-tools" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux (part of the Cadence bundle).<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 82
- 0
Applications:Cadence-Logs.php View File

@@ -0,0 +1,82 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Cadence-Logs";
$PAGE_TYPE = "APPLICATION";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Cadence-Logs");
$PAGE_SOURCE_2 = ARRAY("Applications", "Cadence-Logs");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
Cadence-Logs is a small tool that shows JACK, A2J, LASH and LADISH logs in a multi-tab window.<br/>
This is very similar to the the 'ladilog' app but here the logs are viewed in a text box, making it easy to browse and extract status messages using copy and paste commands.
</p>
<p>
This tool can be executed as 'cadence_logs' or within <a href="<?php echo $ROOT; ?>/Applications:Catia">Catia</a> and
<a href="<?php echo $ROOT; ?>/Applications:Claudia">Claudia</a> from their 'Tools' menu.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
A screenshot follows, showing the JACK log:<br/>
<a href="screenshots/cadence-logs.png" class="external text" rel="nofollow"><img src="screenshots/cadence-logs.png" alt="cadence-logs.png" /></a>
</p>
<p>
It couldn't be simpler: 4 tabs for the different logs and 2 buttons.<br/>
Each tab shows the log for the application indicated in the tab name. If a log does not exist, its tab will not be shown.<br />
(As you can see in the screen-shot above the 'LASH' tab is missing, indicating that its log does not exist in the system).
</p>
<p>
The 'Close' button will, obviously, close the tool window.<br/>
The 'Purge all logs' button will empty <i>all</i> the available logs (it will not delete the files, but overwrite them). If a log file does not exist it will not be created.
</p>

<!-- Usage -->
<h3><span class="mw-headline" id="Usage"> Usage </span></h3>
<p>
This is a very small tool with a very small purpose: to quickly view the audio-related logs and allow you to copy&amp;paste from them.<br/>
The logs are actually files that exist within your home folder. The full filenames for each log are:<br/>
</p>
<ul>
<li>JACK: ~/.log/jack/jackdbus.log</li>
<li>A2J: ~/.log/a2j/a2j.log</li>
<li>LASH: ~/.log/lash/lash.log</li>
<li>LADISH: ~/.log/ladish/ladish.log</li>
</ul>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Cadence-Logs is available in the KXStudio repositories and ArchLinux AUR ('cadence-tools' package in the KXStudio repositories, 'cadence' in AUR).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/cadence/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://cadence-tools" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux (part of the Cadence bundle).<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 111
- 0
Applications:Cadence-Render.php View File

@@ -0,0 +1,111 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Cadence-Render";
$PAGE_TYPE = "APPLICATION";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Cadence-Render");
$PAGE_SOURCE_2 = ARRAY("Applications", "Cadence-Render");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
Cadence-Render is a tool to record (or 'render') a JACK project using jack-capture, controlled by JACK Transport.<br/>
It supports a vast number of file types and can render in both realtime and freewheel modes.<br/>
</p>
<p>
This tool can be executed as 'cadence_render' or within <a href="<?php echo $ROOT; ?>/Applications:Catia">Catia</a> and
<a href="<?php echo $ROOT; ?>/Applications:Claudia">Claudia</a> from their 'Tools' menu.<br/>
The minimum required version of jack-capture is 0.9.60. If jack-capture is not found in $PATH, Cadence-Render will refuse to run.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
A screenshot follows:<br/>
<a href="screenshots/cadence-render.png" class="external text" rel="nofollow"><img src="screenshots/cadence-render.png" alt="cadence-render.png" /></a>
</p>
<p>
You have two render modes: Realtime and Freewheel (more on that below).<br/>
The Start and End Time specifies what part of the JACK project to record. The "now" buttons will change their values to the current JACK Transport location.<br/>
Which encoding formats are available will depend on your current jack-capture version. Newer versions should support more formats. mp3 is not an option for the time being.<br/>
</p>
<p>
When recording, the 'Render' button will change to 'Stop', and the progress bar will slowly fill indicating how much percentage of the project has been rendered so far.<br/>
The rest of the interface is pretty straight forward.
</p>

<!-- Usage -->
<h3><span class="mw-headline" id="Usage"> Usage </span></h3>
<p>
Cadence-Render uses jack-capture to do the actual recording in the background.<br/>
When 'Render' is pressed it will change the JACK buffer-size first (if modified), relocate Transport to the position specified in "Start Time" and then start recording.<br/>
The recording will automatically stop when JACK Transport reaches the time set in "End Time". If the buffer-size was changed, it will be changed back.<br/>
This makes it particularly useful to render projects in freewheel mode with apps that don't support it directly.
</p>
<p>
Changing the buffer size before recording might be useful if you use plugin automation in hosts that don't support per-sample automation.<br/>
The way this works is that a plugin process() call is only called once per JACK callback and thus a plugin parameter will have low precision.<br/>
Having a lower buffer size means the host will have to call process() more often (thus increasing precision), but at a cost of higher CPU usage.<br/>
But note that, if the host or plugin takes too much time in the JACK callback, the audio buffer will not be filled properly and you'll most likely hear "cracks" (aka xruns). <!--<br/>-->
Freewheel mode avoids these issues (see below).
</p>
<p>
The recordings will be saved in the "Output folder" named as "jack_capture_#.ext", where '#' is a number suffix and '.ext' the appropriate extension for the selected encoding format.
</p>
<p>
NOTE: We recommend the use of padding in your songs (ie, put some silence before the beginning and end of a song).<br/>
This is because the very first sounds at the beginning of a song might not be timed properly (JACK apps need to catch up with the transport and start rolling). A padding of 8 beats is usually enough here.<br/>
Also, when some applications reach their song end they might start-over transport at 0:00, which will cause the recording to never reach the "End Time" and thus never stop.
</p>

<!-- Extra -->
<h3><span class="mw-headline" id="RealtimeVsFreewheel"> Realtime vs. Freewheel </span></h3>
<p>
In short, Realtime is the "live" version of audio you hear when making music. If you hear what you're doing, you're on realtime mode.<br/>
Freewheel is the "offline" version, where audio (and midi) is processed as fast as possible. You won't hear anything when in this mode.<br/>
During freewheel JACK will not allow new clients to be registered or connections to be made. It's literally meant to be used for recordings.
</p>
<p>
Rendering in freewheel is sometimes useful because both host and plugins can take as much time as they need to process, independently of the buffer size.<br/>
This is also useful when your project gets too big and can no longer play in realtime without xruns.
</p>
<p>
Not all applications work in freewheel mode though, for example if it relies on any kind of event communication other than JACK-MIDI (like ALSA-MIDI or OSC).<br/>
This is because JACK is running faster than realtime, so any external events can't catch up in time.<br/>
We encourage you to use JACK-MIDI whenever possible. Not only does it allow freewheel rendering but also provides perfect timing between applications.
</p>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Cadence-Render is available in the KXStudio repositories and ArchLinux AUR ('cadence-tools' package in the KXStudio repositories, 'cadence' in AUR).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/cadence/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://cadence-tools" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux (part of the Cadence bundle).<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 93
- 0
Applications:Cadence-XYController.php View File

@@ -0,0 +1,93 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Cadence-XY Controller";
$PAGE_TYPE = "APPLICATION";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Cadence-XYController");
$PAGE_SOURCE_2 = ARRAY("Applications", "Cadence-XY Controller");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
Cadence-XY Controller is a simple XY widget that sends and receives data from Jack MIDI.<br/>
It can send data through specific channels and has a MIDI Keyboard too.
</p>
<p>
This tool can be executed as 'cadence_xycontroller'.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
A screenshot follows showing the piano, running under <br/>
<a href="screenshots/cadence-xycontroller.png" class="external text" rel="nofollow"><img src="screenshots/cadence-xycontroller.png" alt="cadence-xycontroller.png" /></a>
</p>
<p>
Another screenshot, now running under Windows 8:<br/>
<a href="screenshots/cadence-xycontroller_win8.png" class="external text" rel="nofollow"><img src="screenshots/cadence-xycontroller_win8.png" alt="cadence-xycontroller_win8.png" /></a>
</p>
<p>
The XY widget is controlled by the mouse, and it syncs its values to the X and Y knobs. Moving the knobs will change the XY cursor accordingly.<br/>
The "Smooth" checkbox will make XY cursor changes smoother (the cursor will follow the mouse with inertia), but it will not change the knobs' behaviour.
</p>
<p>
There's also a MIDI-keyboard that is usually hidden (use "Settings" menu, "Show MIDI Keyboard" to show or hide it).<br/>
You can use the mouse or keyboard to trigger notes. The keyboard uses a 'qwerty' layout.
</p>

<!-- Usage -->
<h3><span class="mw-headline" id="Usage"> Usage </span></h3>
<p>
The first thing to do after starting this tool is to make the proper JACK connections so that it outputs the data somewhere (<a href="<?php echo $ROOT; ?>/Applications:Catia">Catia</a> does the job nicely).<br/>
</p>
<p>
Cadence-XY Controller can both receive and send MIDI data. This data will not pass-through, which is intentional and not a design failure.<br/>
MIDI channels used can be specified in the "Settings" menu. If data is received on a channel it's not set to listen to, such data will be ignored.
</p>
<p>
MIDI data will be sent whenever the keyboard or XY cursor changes. When everything is stationary, no data is sent.<br/>
MIDI-Keyboard actions will send regular MIDI note-on/offs. XY cursor changes will send MIDI data that look like this:<br/>
<code>
Status: &nbsp;0xB0 + <i>channel</i> - 1<br/>
Control: 0x01 <i>(Modulation, as defined in "X Controls")</i><br/>
Value: &nbsp;&nbsp;<i>X value percentage</i> * 127 / 100<br/>
</code><br/>
</p>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Cadence-XYController is available in the KXStudio repositories and ArchLinux AUR ('cadence-tools' package in the KXStudio repositories, 'cadence' in AUR).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/cadence/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://cadence-tools" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux and Windows (part of the Cadence bundle).<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-win32.zip/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Windows 32bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 85
- 0
Applications:Cadence.php View File

@@ -0,0 +1,85 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Cadence";
$PAGE_TYPE = "APPLICATION_NU";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Cadence");
$PAGE_SOURCE_2 = ARRAY("Applications", "Cadence");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
Cadence is a set of tools useful for audio production.<br/>
Cadence itself is also an application (the main one), which this page will document.<br/>
There are other applications that are part of the Cadence suite, they are usually named as the "Cadence tools".<br/>
They are:
</p>
<ul>
<li><a href="<?php echo $ROOT; ?>/Applications:Catarina">Catarina</a></li>
<li><a href="<?php echo $ROOT; ?>/Applications:Catia">Catia</a></li>
<li><a href="<?php echo $ROOT; ?>/Applications:Claudia">Claudia</a></li>
</ul>
<p>
Some of these also have sub-tools, such as Cadence-JackMeter and Claudia-Launcher.<br/>
Each of these sub-tools is properly documented in its respective page.
</p>
<p>
Cadence can be executed as 'cadence'.<br/>
Running it with '--minimized' makes it start minimized in the systray.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
A screenshot of the first, "System" tab:<br/>
<i>(The panels on the left display system information and checks, and on the right you have the current status of the JACK server and bridges)</i><br/>
<a href="screenshots/cadence1.png" class="external text" rel="nofollow"><img src="screenshots/cadence1.png" alt="cadence1.png"/></a>
</p>
<p>
A screenshot of the second, "Tools" tab:<br/>
<i>(The screenshots are clickable, which will start their respective tools)</i><br/>
<a href="screenshots/cadence2.png" class="external text" rel="nofollow"><img src="screenshots/cadence2.png" alt="cadence2.png"/></a>
</p>
<p>
A screenshot of the third, "Tweaks" tab:<br/>
<i>(This tab allows you to carry out some audio and system related tasks. Some options are not available on certain systems)</i><br/>
<a href="screenshots/cadence3.png" class="external text" rel="nofollow"><img src="screenshots/cadence3.png" alt="cadence3.png"/></a>
</p>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Cadence is available in the KXStudio repositories and ArchLinux AUR (both with 'cadence' package name).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/cadence/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://cadence" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux and Windows.<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-win32.zip/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Windows 32bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 60
- 0
Applications:Carla-Control.php View File

@@ -0,0 +1,60 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Carla-Control";
$PAGE_TYPE = "APPLICATION_NU";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Carla-Control");
$PAGE_SOURCE_2 = ARRAY("Applications", "Carla-Control");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
This is a dummy page, a placeholder for when the real page is written.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
TODO
</p>

<!-- Usage -->
<h3><span class="mw-headline" id="Usage"> Usage </span></h3>
<p>
TODO
</p>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Carla is available in the KXStudio repositories and ArchLinux AUR (both with 'carla' package name).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/carla/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://carla" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux (part of the Carla bundle).<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/carla/Carla-1.1.0-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/carla/Carla-1.1.0-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Carla" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Carla/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 132
- 0
Applications:Carla.php View File

@@ -0,0 +1,132 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Carla";
$PAGE_TYPE = "APPLICATION";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Carla");
$PAGE_SOURCE_2 = ARRAY("Applications", "Carla");
include_once("includes/header.php");
?>

<!-- Intro -->
<p>
Carla is an audio plugin host, with support for many audio drivers and plugin formats.<br/>
It has some nice features like automation of parameters via MIDI CC (and send output back as MIDI too) and full OSC control.<br/>
</p>
<p>
Carla currently supports LADSPA (including LRDF), DSSI, LV2, and VST plugin formats, plus GIG, SF2 and SFZ file support.<br/>
It uses JACK as the default and preferred audio driver but also supports native drivers like ALSA, DirectSound or CoreAudio.<br/>
</p>
<p>
There are 3 types of engine processing:
</p>
<ul>
<li><b>Multi-client</b>: (JACK driver only)<br/>
Every single plugin is exposed as a new JACK client. Audio and MIDI ports are registered as needed.
</li>
<li><b>Single-client</b>: (JACK driver only)<br/>
Same as Multi-client, except that all JACK ports belong to a single master client.<br/>
This is needed when a setup doesn't support multi-client JACK apps, such as LADISH.
</li>
<li><b>Rack</b>:<br/>
Plugins are processed in order, from top to bottom.<br/>
Plugins with non-stereo audio channels are not supported, but a forced-stereo option is available for Mono ones.
</li>
</ul>
<p>
Note: The internal patchbay does not save/restore connections yet, so you'll want to run Carla under some kind of Session Management. LADISH level 1 and NSM are implemented.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
By default Carla uses its own internal theme, a screenshot of it follows along with some plugins:<br/>
<a href="screenshots/carla.png" class="external text" rel="nofollow"><img src="screenshots/carla.png" alt="carla.png" /></a><br/>
The user can keep the custom theme but use system colors, or simply disable the custom theme altogether.<br/>
The result may not be as nice though.<br/>
</p>
<p>
The 'Patchbay' uses the same canvas engine that Catarina, Catia and Claudia do:
<a href="screenshots/carla-patchbay.png" class="external text" rel="nofollow"><img src="screenshots/carla-patchbay.png" alt="carla-patchbay.png" /></a>
</p>
<p>
The last tab "Log" simply prints debug info from time to time when an internal error occurs, in a way that doesn't disturb the user.<br/>
This tab is not available in the Windows version.<br/>
</p>

<!-- Usage -->
<h3><span class="mw-headline" id="Usage"> Usage </span></h3>
<p>
The first time you run Carla you'll most likely want to scan for plugins.<br/>
You can configure your plugin folders in the settings if needed. When done, use "Add New Plugin" in the toolbar, then press the "Refresh" button.<br/>
</p>
<p>
Because Carla is a somewhat complex application, a single page is not enough to cover it entirely.<br/>
(We're currently writing the rest of the pages so be back soon!)
</p>
<!-- <ul> -->
<!-- <li></li> -->
<!-- </ul> -->

<!-- Release Notes -->
<h3><span class="mw-headline" id="ReleaseNotes"> Release Notes </span></h3>
<p>
The following are the release notes for version 1.0.2:
</p>
<ul>
<li>Canvas does not save or restore connections.<br/>
You need to use external session management for now.</li>

<li>LADISH does not support multi-client JACK applications.<br/>
To prevent any issues Carla will switch to single-client mode automatically.</li>

<li>Rack mode is still a bit experimental, specially on non-JACK drivers.</li>

<li>LV2 plugin support is incomplete (although already in a good state).<br/>
Plugins that use CV ports or Worker extension will not work right now.</li>

<li>Carla will not work with non-native LV2 Plugin UIs that require the instance-data extension.<br/>
This is by design and not a bug.</li>

<li>OSC control seems to work well, but has not been tested in great detail.<br/>
Be sure to report any issues.</li>

<li>Carla "PRO" theme, Carla-Control and ZynAddSubFX internal plugin are not available for Windows at this point.</li>
</ul>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Carla is available in the KXStudio repositories and ArchLinux AUR (both with 'carla' package name).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/carla/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://carla" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux and Windows.<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/carla/Carla-1.1.0-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/carla/Carla-1.1.0-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/carla/Carla-1.1.0-win32.zip/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Windows 32bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Carla" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Carla/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 95
- 0
Applications:Catarina.php View File

@@ -0,0 +1,95 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Catarina";
$PAGE_TYPE = "APPLICATION_NU";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Catarina");
$PAGE_SOURCE_2 = ARRAY("Applications", "Catarina");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
Catarina is a Patchbay test app, created while the PatchCanvas module was being developed.<br/>
It allows the user to experiment with the patchbay, without using ALSA, JACK or LADISH.<br/>
You can save &amp; load patchbay configurations too.<br/>
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
A screenshot follows:<br/>
<a href="screenshots/catarina.png" class="external text" rel="nofollow"><img src="screenshots/catarina.png" alt="catarina.png" /></a>
</p>
<p>
The 'File' menu and 'Project' toolbar provides actions related to projects: the common new, open and save.<br/>
The 'Patchbay' menu and toolbar allows you to control what's inside the canvas. You can add/remove groups, add/remove ports and manage connections.<br/>
The 'Canvas' menu and toolbar gives you control over the canvas zoom. The menu has actions for printing and saving an image of the current canvas.<br/>
</p>
<p>
As with all the Cadence tools, you can hide the toolbar via 'Settings' menu, and also configure Catarina.<br/>
The configure dialog looks like this:<br/>
<a href="screenshots/catarina-configure.png" class="external text" rel="nofollow"><img src="screenshots/catarina-configure.png" alt="catarina-configure.png" /></a>
</p>
<p>
You can change the theme used for the canvas (more on that below) and wherever or not to use bezier lines (will use straight lines if off).<br/>
Fancy Eye-candy has 3 states:
</p>
<ul>
<li>Unchecked (None): no eye-candy;</li>
<li>Partially (Small): applies drop-shadow to the boxes, this is the default;</li>
<li>Checked (Full): box drop-shadow, fade-in/out animations and line glow;</li>
</ul>
<p>
<i>(Note: Full eye-candy currently is EXPERIMENTAL, and will make Catarina crash at random times. The cause of the crashes are under investigation).</i><br/>
</p>
<p>
You can also enable OpenGL for the canvas (so the entire 2D space is rendered in the GPU, which makes big projects render much faster) and Anti-aliasing.<br/>
OpenGL is experimental within Qt4 itself, and will not work properly on all systems.<br/>
Anti-aliasing has 3 states:
</p>
<ul>
<li>Unchecked (None): disable all anti-aliasing;</li>
<li>Partially (Small): applies only to the lines, this is the default;</li>
<li>Checked (Full): apply anti-aliasing everywhere;</li>
</ul>
<p>
Settings will be applied as soon as you press 'OK', no need to restart Catarina.<br/>
</p>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Catarina is available in the KXStudio repositories and ArchLinux AUR ('catarina' package in the KXStudio repositories, 'cadence' in AUR).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/cadence/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://catarina" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux and Windows (part of the Cadence bundle).<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-win32.zip/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Windows 32bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 59
- 0
Applications:Catia.php View File

@@ -0,0 +1,59 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Catia";
$PAGE_TYPE = "APPLICATION_NU";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Catia");
$PAGE_SOURCE_2 = ARRAY("Applications", "Catia");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
Catia is a JACK Patchbay, with some neat features like A2J bridge support and JACK Transport.<br/>
It's supposed to be as simple as possible so it can work nicely on non-Linux platforms.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
A screenshot follows:<br/>
<a href="screenshots/catia.png" class="external text" rel="nofollow"><img src="screenshots/catia.png" alt="catia.png" /></a>
</p>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Catia is available in the KXStudio repositories and ArchLinux AUR ('catia' package in the KXStudio repositories, 'cadence' in AUR).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/cadence/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://catia" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux and Windows (part of the Cadence bundle).<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-win32.zip/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Windows 32bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 48
- 0
Applications:Claudia-Launcher.php View File

@@ -0,0 +1,48 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Claudia-Launcher";
$PAGE_TYPE = "APPLICATION_NU";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Claudia-Launcher");
$PAGE_SOURCE_2 = ARRAY("Applications", "Claudia-Launcher");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
Claudia-Launcher is a multimedia application launcher with LADISH support.<br/>
It searches for installed packages (not binaries), and displays the respective content as a launcher.<br/>
The content is got through an hardcoded database, created and/or modified to suit the target distribution.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
A screenshot follows:<br/>
<a href="screenshots/claudia-launcher.png" class="external text" rel="nofollow"><img src="screenshots/claudia-launcher.png" alt="claudia-launcher.png" /></a>
</p>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Claudia-Launcher is available in the KXStudio repositories and ArchLinux AUR ('claudia' package in the KXStudio repositories, 'cadence' in AUR).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/cadence/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://claudia" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 57
- 0
Applications:Claudia.php View File

@@ -0,0 +1,57 @@
<?php
$PAGE_TITLE = "KXStudio : Applications : Claudia";
$PAGE_TYPE = "APPLICATION_NU";
$PAGE_SOURCE_1 = ARRAY("/Applications", "/Applications:Claudia");
$PAGE_SOURCE_2 = ARRAY("Applications", "Claudia");
include_once("includes/header.php");
?>

<!-- intro -->
<p>
Claudia is a LADISH frontend; it's just like Catia, but focused at session management through LADISH.<br/>
It has a bit more features than the official LADISH GUI, with a nice preview of the main canvas in the bottom-left.<br/>
It also implements the 'Claudia-Launcher' add-application style for LADISH.
</p>

<!-- Interface -->
<h3><span class="mw-headline" id="Interface"> The Interface </span></h3>
<p>
A screenshot follows:<br/>
<a href="screenshots/claudia.png" class="external text" rel="nofollow"><img src="screenshots/claudia.png" alt="claudia.png" /></a>
</p>

<!-- Download -->
<h3><span class="mw-headline" id="Download"> Download </span></h3>
<p>
Claudia is available in the KXStudio repositories and ArchLinux AUR ('claudia' package in the KXStudio repositories, 'cadence' in AUR).<br/>
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/>
<a href="https://aur.archlinux.org/packages/cadence/" class="external text a_bigger_text" rel="nofollow" target="_blank">
ArchLinux</a> (AUR)<br/>
<img src="images/ico_debian.png" alt="" class="img_text_align_spaced"/>
<a href="apt://claudia" class="external text a_bigger_text">
Debian/Ubuntu</a> (via KXStudio repositories)<br/>
</p>
<p>
Pre-compiled binaries are available for Linux (part of the Cadence bundle).<br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 32bit</a><br/>
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
Linux 64bit</a><br/>
</p>
<p>
The latest source code is hosted on github, together with bug reports, feature requests, etc.<br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence" class="external text a_bigger_text" rel="nofollow" target="_blank">
Source code</a><br/>
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/>
<a href="https://github.com/falkTX/Cadence/issues?state=open" class="external text a_bigger_text" rel="nofollow" target="_blank">
Bug reports / Feature requests</a><br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 84
- 0
Artwork.php View File

@@ -0,0 +1,84 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "KXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Artwork");
$PAGE_SOURCE_2 = ARRAY("Artwork");
include_once("includes/header.php");
?>

<p>The KXStudio Desktop theme uses QtCurve as the rendering engine, making it available on Qt3, KDE3, Qt4, KDE4 and Gtk2 applications.<br />
There is a Metacity and XFWM theme as well.<br />
The icon theme used is Oxygen.
</p><p>Here's some screenshots showing off the theme on different Desktop Environments:<br />
</p>
<table border="1">
<tr>
<td align="center">
<p><a href="screenshots/kxstudio-kde3.png" class="external text" rel="nofollow"><img src="screenshots/thumb/kxstudio-kde3.png" alt="kxstudio-kde3.png" /></a><br />
KDE3 (Trinity)
</p>
</td>
<td align="center">
<p><a href="screenshots/kxstudio-kde4.png" class="external text" rel="nofollow"><img src="screenshots/thumb/kxstudio-kde4.png" alt="kxstudio-kde4.png" /></a><br />
KDE4
</p>
</td>
<td align="center">
<p><a href="screenshots/kxstudio-xfce.png" class="external text" rel="nofollow"><img src="screenshots/thumb/kxstudio-xfce.png" alt="kxstudio-xfce.png" /></a><br />
XFCE
</p>
</td>
</tr>
</table>
<p>You can get the entire artwork in the <a href="Downloads" title="Downloads">Downloads</a> section, just like any other application from us.
</p><p><br />
To properly apply this theme, you can follow these steps:
</p>
<ul>
<li>Install QtCurve (minimum KDE4 / Gtk2, Qt3 optional)</li>
<li>Set KDE color-scheme using the 'KXStudio.colors' provided</li>
<li>Set KDE widget style to QtCurve</li>
<li>Configure KDE QtCurve style, and load the 'KXStudio.qtcurve' config</li>
<li>Set Gtk2 theme to KXStudio (KXStudio decoration, QtCurve style, Oxygen icons)</li>
<li>Set Qt4/Qt3 style to QtCurve (using qtconfig-qt4/qt3)</li>
</ul>
<p>A XFWM decoration theme is available for XFCE. You might want to use 'Oxygen Mono Light|Dark' to get monochrome panel applets.<br />
Please note that Gtk3 is not supported at the moment.
</p><p><br />
</p>
<h2> <span class="mw-headline" id="The_Desktop_Session">The Desktop Session</span></h2>
<p>Besides the theme, the "KXStudio Desktop" also consists of (resumed):
</p>
<ul>
<li>JACK integration</li>
<li>Audio Session management through LADISH</li>
<li>One-app-to-rule them all (Cadence)</li>
</ul>
<p><br />
<b>JACK integration</b><br />
We're talking about making the whole system JACK dependant. JACK is started as soon as the user logs in, using the last session settings or a pre-setup LADISH Studio.<br />
For non-JACK aware apps, bridges are used.<br />
&#160;<i>PulseAudio</i> works nicely with JACK, although it needs a bit medium/high buffer size in order to work properly.<br />
&#160;<i>ALSA</i> has a plugin for JACK too, although it's not perfectly stable.<br />
&#160;<i>SDL</i>-Audio applications will need either a SDL-&gt;OSS-&gt;JACK, SDL-&gt;ALSA-&gt;JACK or SDL-&gt;PulseAudio-&gt;JACK bridge, since there's no native JACK support in SDL. If you're able to get an OSS-&gt;JACK bridge working, use it as it is preferred.
</p><p><br />
<b>Audio Session management through LADISH</b><br />
There needs to be a tool to manage audio projects (and non-audio as well), and LADISH already provides this functionality.<br />
By integrating with LADISH, we can set-up custom JACK settings, apps and connections, and load it at any time, even when login in.
</p><p><br />
<b>One-app-to-rule them all (Cadence)</b><br />
Cadence is our own app that controls the whole audio system, using JACK and LADISH.<br />
This is pre-alpha software though, and it's not even released yet (although it's already present in the KXStudio repositories for testing).<br />
<i>A full Cadence explanation/tutorial will be available once it reaches Alpha 1 (first public release)</i>
</p><p><br />
</p>
<h2> <span class="mw-headline" id="The_Desktop_Environment">The Desktop Environment</span></h2>
<p>There are plans to make our own Desktop Enviroment (including Window Manager), based on <a href="http://www.niallmoody.com/apps/twindy" class="external text" rel="nofollow">Twindy</a>.<br />
A *Mock-up* can be seen <a href="tmp/scr026.png" class="external text" rel="nofollow">here</a>.<br />
There's nothing done for it yet, and it won't be so soon, as there is plenty of stuff to do first&#160;;)
</p>
<p><br /></p>

<?php
include_once("includes/footer.php");
?>

+ 43
- 0
Development.php View File

@@ -0,0 +1,43 @@
<?php
$PAGE_TITLE = "KXStudio : Development";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Development");
$PAGE_SOURCE_2 = ARRAY("Development");
include_once("includes/header.php");
?>

<p>
This page is meant for people that want to contribute to KXStudio.
</p>
<p>
Please note that KXStudio has project pages in both SourceForge and Launchpad (you can check the respective links on the left).<br/>
SourceForge does the website, code and repository hosting, while Launchpad is used for managing bugs, questions/answers and the RSS news feed.<br/>
The Cadence tools don't use SourceForge or Launchpad, but are hosted on github instead at <a href="https://github.com/falkTX/Cadence" class="external text" rel="nofollow" target="_blank">https://github.com/falkTX/Cadence</a>.
</p>
<p>
If you're looking to report a bug in the Cadence tools, use the github "Issues" interface available <a href="https://github.com/falkTX/Cadence/issues" class="external text" rel="nofollow" target="_blank">here</a>.<br/>
For KXStudio related bugs <a href="https://bugs.launchpad.net/kxstudio" class="external text" rel="nofollow" target="_blank">click here</a>.<br/>
<br/>
</p>

<p>
Regarding KXStudio development, we currently need:
</p>
<ul>
<li>A Graphic designer that can make Gtk3 themes</li>
<li>Anyone that would like to make some good video tutorials</li>
<li>Non-Ubuntu users to beta-test the Cadence tools</li>
</ul>

<p>
In any case, you should always check the <a href="<?php echo $ROOT; ?>/Development:TODO">KXStudio TODO List</a> to find out what you can do.<br />
(You don't need to know programming to help).
</p>
<p>
KXStudio future plans are discussed <a href="http://linuxmusicians.com/viewtopic.php?f=47&amp;t=8078" class="external text" rel="nofollow" target="_blank">here</a>.
</p>
<br/>

<?php
include_once("includes/footer.php");
?>

+ 36
- 0
Development:TODO.php View File

@@ -0,0 +1,36 @@
<?php
$PAGE_TITLE = "KXStudio : Development : TODO";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Development", "/Development/TODO");
$PAGE_SOURCE_2 = ARRAY("Development", "TODO");
include_once("includes/header.php");
?>

<p>
This page contains a list of things left to do for KXStudio.<br/>
<br/>
</p>

<p>
<b>Tasks for common people (not Team restricted):</b>
</p>
<ul>
<li><s>KXStudio Dark Metacity theme (based on Ambiance)</s></li>
<li>KXStudio Gtk3 Theme port <i>(In progress)</i></li>
<p>
Work has already been done for this, but it's still far from finished.<br/>
The current theme uses the <a href="http://gnome-look.org/content/show.php?content=142331" class="external text" rel="nofollow" target="_blank">solidity-gtk3 engine</a>.<br/>
It's available in the latest KXStudio Artwork release.
</p>
<li>Make kxstudio-menu module work on all systems <i>(In progress)</i></li>
<p>
kxstudio-menu has been proven to work on Gnome2, KDE3, KDE4 and XFCE4.<br />
It may not work on LXDE, needs testing (any LXDE users here?).
</p>
<li>QJackCtl needs to support proper jackdbus save/load, so it shares configuration with Cadence and laditools</li>
</ul>
<br/>

<?php
include_once("includes/footer.php");
?>

+ 77
- 0
Documentation.php View File

@@ -0,0 +1,77 @@
<?php
$PAGE_TITLE = "KXStudio : Documentation";
$PAGE_TYPE = "KXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation");
$PAGE_SOURCE_2 = ARRAY("Documentation");
include_once("includes/header.php");
?>

<p>
If you're looking for help regarding an Ubuntu feature, please search within the
<a href="http://ubuntuforums.org/" class="external text" rel="nofollow">Ubuntu Forums</a>.<br/>
You can also use IRC, channel #kxstudio, server irc.freenode.net (or irc.freenode.com).
</p>
<p>
Please note that documentation for KXStudio is a work in progress, if you need some information not available here, you can try:
</p>
<ul>
<li><a href="http://www.wiki.linuxmusicians.com/doku.php" class="external text" rel="nofollow">LinuxMusicians Wiki</a></li>
<li><a href="https://help.ubuntu.com/community/UbuntuStudio/HowTos" class="external text" rel="nofollow">UbuntuStudio Community Documentation</a></li>
</ul>

<!-- TOPICS -->
<p>
<br/>
Some useful topics:
</p>

<!-- KXSTUDIO RELEASE -->
<p>
<b>KXStudio 12.04.3 Release</b>
</p>
<ul>
<li><a href="<?php echo $ROOT; ?>/Documentation:KXStudio12043:ReleaseNotes">Release Notes</a></li>
</ul>

<!-- KXSTUDIO DISTRIBUTION -->
<p>
<br/>
<b>KXStudio Distribution &amp; Repositories</b>
</p>
<ul>
<li><a href="<?php echo $ROOT; ?>/Documentation:Ubuntu:Meta-Packages">Available Meta-Packages</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Ubuntu:RegisterCommercial">Register/Activate your purchased software</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Ubuntu:Upgrade">Upgrade from an existing Ubuntu installation</a></li>
</ul>

<!-- KXSTUDIO MANUAL -->
<p>
<br/>
<b>KXStudio Manual</b>
</p>
<ul>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:kxstudio_introduction">Introduction</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:kxstudio_and_free_software">KXStudio and Free Software</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:downloading_and_booting_kxstudio">Downloading, booting and running KXStudio 'live'</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:installing_kxstudio">Installing KXStudio</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:package_management">Package Management</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:video_drivers">Installing non-free video drivers</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:included_and_recommended_apps">Included and recommended apps</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:linux_audio_overview">Linux Audio Overview</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:alsa_and_kxstudio">ALSA and KXStudio</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:cadence_introduction">An introduction to Cadence</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:jack_configuration">JACK Configuration</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:simple_claudia_studio">Creating a simple LADISH studio using Claudia</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:latency">Latency compensation and xrun reduction tips</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:wineasio_and_reaper">WineASIO and REAPER</a></li>
<li><a href="<?php echo $ROOT; ?>/Documentation:Manual:useful_links_and_getting_help">Useful Links And Getting Help</a></li>
</ul>
<p>
(The manual is being written by Dan MacDonald with the assistance of Aaron Wolf, falkTX and the LinuxMusicians community).
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 84
- 0
Documentation:KXStudio12041:NetBootInstall.php View File

@@ -0,0 +1,84 @@
<?php
$PAGE_TITLE = "KXStudio Documentation";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio12041:NetBootInstall");
$PAGE_SOURCE_2 = ARRAY("Documentation", "KXStudio 12.04.1", "NetBootInstall");
include_once("includes/header.php");
?>

<p>
This section describes how to install a minimal Ubuntu system using a Net-Boot ISO.<br/>
After the base install is done, we'll proceed to upgrade Ubuntu to KXStudio.
</p>
<p>
There are some requirements you need to check before trying this:<br/>
1 - Your system is connected to the internet via cable;<br/>
2 - You've downloaded and burned a KXStudio Net-Boot ISO into a CD;<br/>
</p>

<p><br/></p>

<h5><span class="mw-headline" id="Step1">Step 1 - Boot from the ISO</span></h5>
<p>
Make sure your PC is booting from CD drives (the F8 or F9 key during bios splash usually can change the boot media).<br/>
If you can't find the key for that, make sure the CD drive is 1st device the PC tries to boot from (there's an option for that in the BIOS).
</p>

<p><br/></p>

<h5><span class="mw-headline" id="Step2">Step 2 - Install the base system</span></h5>
<p>
When you boot from the ISO, the first thing you'll see is a list of languages - pick yours.<br/>
Tip: Use the 'F3' key now to change the default keyboard language too.
</p>
<p>
Now just click 'Enter' to start the installation.
</p>
<p>
You'll notice this installation method looks rather old, but it's this way because we didn't load any drivers or special stuff yet.<br />
You can browse through the interface using the keyboard. The mouse does nothing at this point.
</p>
<p>
This installation method is exactly the same in an Ubuntu or Debian net-boot ISO, and it's very similar to the "alternate" method.<br />
Note that if you never used this kind of methods to install a Linux system before, you probably should not install KXStudio this way!<br />
Please go with UbuntuStudio 12.04 as a base install, and upgrade to KXStudio afterwards.
</p>
<p>
Once you've installed the base system, it will automatically reboot.
You can remove the CD now.
</p>

<p><br/></p>
<h5><span class="mw-headline" id="Step3">Step 3 - Enable the repositories</span></h5>
<p>
Login in the terminal with the user credentials you entered during the installation.<br />
Note: You won't get any feedback while entering the password - this is normal (actually a security feature).
</p>
<p>
When logged in, run these commands to enable the KXStudio repositories:<br/>
<code>
sudo apt-get update<br/>
sudo apt-get install python-software-properties wget<br/>
sudo add-apt-repository ppa:kxstudio-team/kxstudio<br/>
sudo apt-get update<br/>
sudo apt-get install kxstudio-repos<br />
sudo apt-get update<br/>
</code>
</p>

<p><br/></p>

<h5><span class="mw-headline" id="Step4">Step 4 - Install the KXStudio Desktop</span></h5>
<p>
For this "final" step, you can follow the <a href="<?php echo $ROOT; ?>/Documentation:Ubuntu:Upgrade">Upgrade From Ubuntu</a> tutorial, since the steps are the same.<br />
Just skip to the Step 2 - <a href="<?php echo $ROOT; ?>/Documentation:Ubuntu:Upgrade#Step2">direct link</a>
</p>
<p>
Of course, you won't have any GUI at this point, so you need to use the command-line methods.
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 54
- 0
Documentation:KXStudio12041:ReleaseNotes.php View File

@@ -0,0 +1,54 @@
<?php
$PAGE_TITLE = "KXStudio Documentation";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio12041:ReleaseNotes");
$PAGE_SOURCE_2 = ARRAY("Documentation", "KXStudio 12.04.1", "Release Notes");
include_once("includes/header.php");
?>

<p>
These are the release notes related to the KXStudio 12.04.1 Release, based on Ubuntu 12.04.1 LTS.<br/>
We recommend you to take a look at the Ubuntu's 12.04 release notes too,
<a href="https://wiki.ubuntu.com/PrecisePangolin/ReleaseNotes" class="external text" rel="nofollow">here</a>.<br/>
(Read the 'Kubuntu' notes if you use KDE, 'Xubuntu' for XFCE and so on).
</p>

<p><br/></p>

<h4><span class="mw-headline" id="LiveDVDNotes">KXStudio 12.04.1 Live-DVD Notes</span></h4>
<ul>
<li>The live session user name is "kxstudio" and has no password.</li>
<li>Because Carla is still unfinished, FeSTige is currently on the DVD (and thus in the default install).<br/>
This is only temporary, FeSTige is no longer being developed and will be soon replaced by Carla functionality.</li>
<li>Sometimes the keyboard layout is not set-up correctly on the live session. This can be manually fixed by running:<br/>
<code>setxkbmap pt</code> <i>(replace 'pt' by the relevant keyboard layout/language).</i></li>
<li>The guitarix version included in the DVD has CPU optimizations enabled and may not work on older systems.<br/>
This can be fixed by updating its package during the live session.</li>
<li>The list of packages installed on the Live-DVD is available
<a href="<?php echo $ROOT; ?>/Paste/GvxoV" class="external text" rel="nofollow">here</a> for 32bit and
<a href="<?php echo $ROOT; ?>/Paste/nUP7n" class="external text" rel="nofollow">here</a> for 64bit.</li>
</ul>

<p><br/></p>

<h4><span class="mw-headline" id="CurrentNotes">Current 12.04.1 Notes</span></h4>
<ul>
<li>The Carla tool is unfinished, and as such it will show a warning every-time you start it.<br/>
We're working hard to make it complete and stable as soon as possible, so stay tuned.</li>
<li>Only KDE4 is officially supported now. XFCE will also work but your experience may not be as great.<br/>
Other desktops are unsupported at this point.</li>
<li>Ubuntu is focused at PulseAudio and doesn't provide good raw/ALSA mixers by default if you're Desktop is not KDE.<br/>
On such cases you should disable the PulseAudio mixer and use another tool (such as kmix, qamix, volti or alsamixer).<br/>
You may need to reconfigure the multimedia global shortcuts to use the new mixer</li>
<li>Some applications and websites don't work nicely with dark themes, which KXStudio uses by default.<br/>
This is not a bug in the theme(s) but rather upstream (ie, app and website authors).<br/>
We encourage users to report such issues upstream so they can be fixed for everyone using dark themes.</li>
<li>Synaptic is now used for handle package management in KXStudio, and as such users won't receive update notifications anymore.<br/>
Users should open synaptic and do system updates on a regular basis.</li>
</ul>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 46
- 0
Documentation:KXStudio12043:ReleaseNotes.php View File

@@ -0,0 +1,46 @@
<?php
$PAGE_TITLE = "KXStudio Documentation";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio12041:ReleaseNotes");
$PAGE_SOURCE_2 = ARRAY("Documentation", "KXStudio 12.04.3", "Release Notes");
include_once("includes/header.php");
?>

<p>
These are the release notes related to the KXStudio 12.04.3 Release, based on Ubuntu 12.04.3 LTS.<br/>
We recommend you to take a look at the Ubuntu's 12.04 release notes too,
<a href="https://wiki.ubuntu.com/PrecisePangolin/ReleaseNotes" class="external text" rel="nofollow">here</a>.<br/>
(Read the 'Kubuntu' notes if you use KDE, 'Xubuntu' for XFCE and so on).
</p>

<p><br/></p>

<h4><span class="mw-headline" id="LiveDVDNotes">KXStudio 12.04.3 Live-DVD Notes</span></h4>
<ul>
<li>The live session user name is "kxstudio" and has no password.</li>
<li>Sometimes the keyboard layout is not set-up correctly on the live session. This can be manually fixed by running:<br/>
<code>setxkbmap pt</code> <i>(replace 'pt' by the relevant keyboard layout/language).</i></li>
<li>The list of packages installed on the Live-DVD is available
<a href="<?php echo $ROOT; ?>/Paste/GvxoV" class="external text" rel="nofollow">here</a> for 32bit and
<a href="<?php echo $ROOT; ?>/Paste/nUP7n" class="external text" rel="nofollow">here</a> for 64bit.</li>
</ul>

<p><br/></p>

<h4><span class="mw-headline" id="CurrentNotes">Current 12.04.3 Notes</span></h4>
<ul>
<li>Ubuntu is focused at PulseAudio and doesn't provide good raw/ALSA mixers by default if you're Desktop is not KDE.<br/>
On such cases you should disable the PulseAudio mixer and use another tool (such as kmix, qamix, volti or alsamixer).<br/>
You may need to reconfigure the multimedia global shortcuts to use the new mixer</li>
<li>Some applications and websites don't work nicely with dark themes, which KXStudio uses by default.<br/>
This is not a bug in the theme(s) but rather upstream (ie, app and website authors).<br/>
We encourage users to report such issues upstream so they can be fixed for everyone using dark themes.</li>
<li>The linux 3.8 kernel has a small regression for USB-Audio interfaces, forcing users to use a high JACK buffer-size value.<br/>
If this affects you, consider installing linux-lowlatency-3.2, -3.5 or -3.11 which do not have the issue.</li>
</ul>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 146
- 0
Documentation:Manual:alsa_and_kxstudio.php View File

@@ -0,0 +1,146 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:alsa_and_kxstudio");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "ALSA and KXStudio");
include_once("includes/header.php");
?>

<div class="level1">

<p>

The Advanced Linux Sound Architecture is the primary sound system used by Linux. Even those who only plan to use JACK with the FFADO (FireWire) drivers should still have familiarity with ALSA.
</p>

</div>

<h2><span name="kmix" id="kmix">kmix</span></h2>
<div class="level2">

<p>

The main ALSA mixer included with KXStudio is called kmix. You can use kmix to adjust audio input and output levels, mute and unmute channels and change other non-FireWire audio device settings such as selecting between SPDIF and analog inputs if your device has such features. The kmix system tray icon looks like this:
</p>

<p>
<a href="http://www.wiki.linuxmusicians.com/lib/exe/detail.php?id=alsa_and_kxstudio&amp;cache=cache&amp;media=kmix-tray.png" class="media" title="kmix-tray.png"><img src="http://www.wiki.linuxmusicians.com/lib/exe/fetch.php?w=&amp;h=&amp;cache=cache&amp;media=kmix-tray.png" class="media" title="The kmix icon" alt="The kmix icon" /></a>
</p>

<p>
If you have a scrollwheel function on a mouse or trackpad, you can hover over the kmix tray icon and adjust the Master volume by moving the scrollwheel up and down. If you left-click on the kmix tray icon it will display a mini mixer. To see a full mixer with more controls, click the &#039;Mixer&#039; button within the mini mixer menu.
</p>

<p>
<a href="http://kxstudio.sourceforge.net/screenshots/kmix.png" class="media" title="kmixer.png"><img src="http://kxstudio.sourceforge.net/screenshots/kmix.png" class="media" title="kmix mixer" alt="kmix mixer" /></a>
</p>

<p>
Here we see the main kmix mixer window. kmix displays the controls for each ALSA device on its own separate tab. In this screenshot the &#039;HDA Intel&#039; onboard audio device is selected.
</p>

<p>
You will notice that each fader has a small speaker icon just below it. When these speaker icons display a small red cross on them, as &#039;Beep&#039; does in the screenshot, that indicates the channel is currently muted. You can toggle muting simply by left-clicking on the speaker icons.
</p>

<p>
In the bottom right corner of the mixer window there is a tool icon. This icon allows you to configure which channels are available to control for the currently selected kmix device tab. You may find that some controls you need are missing at first, so you may add them via this Configure Channels window.
</p>

<p>
Whilst there is a standard defined for USB audio devices, relatively few devices fully comply with it. What this means for ALSA and USB devices is that sometimes you will see no controls under kmix for some USB devices or controls may not function as expected. Such issues may be worked around by inserting an app such as Non mixer or jack_mixer between an audio source and the problematic output device until the issue is fixed within ALSA.
</p>

</div>

<h2><span name="cadence_and_alsa" id="cadence_and_alsa">Cadence and ALSA</span></h2>
<div class="level2">

<p>

Cadence is primarily used to control and monitor the various Linux sound systems, including ALSA, under KXStudio. The main Cadence window has a &#039;JACK bridges&#039; section which contains two ALSA/JACK bridges - one for ALSA audio and one for MIDI. You will not hear audio produced by ALSA-only apps when JACK is running if the ALSA audio bridge is stopped. Likewise, you will be unable to access MIDI devices if the ALSA MIDI bridge isn&#039;t running when JACK is.
</p>

</div>

<h2><span name="non-jack_apps" id="non-jack_apps">non-JACK apps</span></h2>
<div class="level2">

<p>

As JACK increases in popularity, it is more widely supported. However, several apps are still ALSA-only. Such apps will have their audio channeled via the same ALSA to JACK bridge. These include:
</p>

<p>
<strong>Adobe Flash Player</strong> (as used by Firefox and other browsers for sites such as YouTube)
</p>

<p>
<strong>Many games and other various programs</strong>
</p>

<p>
Some other apps have only partial JACK support. These work with JACK directly, have their own JACK connections, and function without the ALSA to JACK bridge, but their connections are not persistent. They will temporarily connect to JACK while playing but drop their connection as soon as playback is stopped. Examples of these apps are:
</p>

<p>
<strong>Audacity</strong>
</p>

<p>
<strong>SMPlayer</strong>
</p>

<p>
<strong>VLC</strong>
</p>

<p>
Hence, none of these offer the individual audio routing functionality or other features offered by fully JACK-native software.
</p>

</div>

<h2><span name="useful_alsa_commands" id="useful_alsa_commands">Useful ALSA commands</span></h2>
<div class="level2">

<p>

The following commands can be useful for troubleshooting ALSA issues in a terminal:

</p>
<pre class="code">alsamixer</pre>

<p>

The original ALSA mixer

</p>
<pre class="code">cat /proc/asound/cards</pre>

<p>

Displays attached ALSA devices

</p>
<pre class="code">cat ~/.asoundrc</pre>

<p>

Displays your ALSA configuration file

</p>
<pre class="code">sudo alsactl store 0</pre>

<p>

Saves the current settings for ALSA device 0
</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 150
- 0
Documentation:Manual:cadence_introduction.php View File

@@ -0,0 +1,150 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:cadence_introduction");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "Cadence Introduction");
include_once("includes/header.php");
?>

<div class="level1">

<p>

Cadence controls and monitors various Linux sound systems as well as audio-related system settings. Below is a screenshot of its main window and following that is an explanation of what it all means and how you use it.
</p>

<p>
<a href="http://kxstudio.sourceforge.net/screenshots/cadence1.png" class="media" title="cadence.png"><img src="http://kxstudio.sourceforge.net/screenshots/cadence1.png" class="media" alt="" /></a>
</p>

</div>

<h2><span name="system_information" id="system_information">System Information</span></h2>
<div class="level2">

<p>

This tells you the operating system, kernel version, and whether you are running a 32 or 64 bit <acronym title="Operating System">OS</acronym>. The kernel could be said to be the engine of Linux and KXStudio includes a low-latency kernel which has been optimized to get the best performance from JACK.
</p>

</div>

<h2><span name="system_status" id="system_status">System Status</span></h2>
<div class="level2">

<p>

This lets you select the CPU Scaling Governor, a property of the Linux kernel which controls the CPU speed. In &#039;performance&#039; mode, your CPU will run at full speed all the time. This mode consumes the most power but ensures the best performance and minimum CPU-related sound issues. In many cases (especially on battery powered devices) using &#039;ondemand&#039; makes more sense as this ups the CPU speed when its needed but clocks it back down when the computer is idle which helps save power. <em>Note: to enable this option in KXStudio 12.04.1, you must first install “indicator-cpufreq” but this will be included on install in 12.04.2.</em>
</p>

</div>

<h2><span name="system_checks" id="system_checks">System Checks</span></h2>
<div class="level2">

<p>

Current kernel is a verification that you&#039;re running a realtime or lowlatency kernel. This check will be ticked already if you installed from the KXStudio <acronym title="International Organization for Standardization">ISO</acronym> as it includes a low latency kernel. The other check verifies that your user is included in the audio group. Being a member of the audio group is required for your user to run JACK in realtime mode for optimal performance. You can add your user to the audio group by running:

</p>
<pre class="code">sudo adduser &lt;username&gt; audio</pre>

<p>

Replace &lt;username&gt; with your KXStudio user name when you run that command in a terminal. You will then need to log out and back in or reboot before your user will be recognised as being in the audio group.
</p>

</div>

<h2><span name="jack_status" id="jack_status">JACK Status</span></h2>
<div class="level2">

<p>

<strong>Server Status</strong> tells you if the JACK server is running or not. You cannot run any JACK-dependant software unless the JACK server is started beforehand.
</p>

<p>
<strong>Realtime</strong> tells you if JACK is running with realtime scheduling or not. Realtime scheduling allows JACK to take priority over other programs being run and hence improves performance of JACK applications.
</p>

<p>
<strong>DSP Load</strong> is the current CPU load estimated by JACK. If it gets too high you may experience performance issues.
</p>

<p>
<strong>Xruns</strong> For JACK to operate smoothly and without drop-outs it requires that its buffers (the memory used to transport audio) provide a continuous stream of data. Whenever this data fails to arrive in time to satisfy the requests of a JACK app it causes an xrun which is often accompanied by a disruption to the sound output. The key to success with JACK is to eliminate or avoid xruns.
</p>

<p>
<strong>Buffer</strong> size is measured in frames per second. It determines the latency between the audio being received by JACK and being sent to the output device. The smaller the buffer the lower the latency and, as a result, the higher the accuracy when monitoring audio for multitrack recording. 1024 is the default and is usually a safe value but smaller buffer sizes have less latency, i.e. less delay between the input and output. Try different settings to see how low you can go when recording without getting xruns. The functioning of lower size buffers depends on the power of your CPU and the specifics of your audio device. The lowest buffer most devices can handle well is 64.
</p>

<p>
<strong>Sample rate</strong> is the frequency JACK will run and record audio at. 44.1kHz is the CD audio standard, but 48kHz is more common to go with video or for other typical audio. Higher sample rates allow for higher quality but take more disk space. Even for professional purposes, 48kHz is usually fine as the default.
</p>

<p>
<strong>Latency</strong> is the JACK capture latency which measures the time taken to fill the audio capture buffer. This value is determined by the buffer, period size and samplerate settings used to start JACK.
</p>

</div>

<h2><span name="jack_controls" id="jack_controls">JACK Controls</span></h2>
<div class="level2">

<p>

<strong>Start</strong> Starts the JACK server, if its not running. This is the recommended way to start JACK.
</p>

<p>
<strong>Stop</strong> stops the JACK server. It is wise to save your work in any open JACK apps before stopping JACK, just to be safe.
</p>

<p>
<strong>Force restart</strong> should &#039;Start&#039; fail to start JACK, it is worth trying &#039;Force restart&#039; but you may lose the last changes made to the JACK settings.
</p>

<p>
<strong>Configure</strong> opens the JACK settings window, which is covered in the next chapter.
</p>

<p>
<strong>Switch Master</strong> tells JACK to apply any changes made in the JACK settings window.
</p>

<p>
<strong>Auto-start JACK or LADISH at login</strong> lets you pick if you&#039;d like to start JACK or a LADISH studio at boot. KXStudio includes an app called Claudia which lets you create virtual &#039;LADISH&#039; studios of interlinked audio applications. After creating such a studio within Claudia, you can use Cadence to configure your machine boot into a saved LADISH studio configuration. Starting a LADISH studio at boot also starts JACK using the settings defined within the studio.
</p>

</div>

<h2><span name="jack_bridges" id="jack_bridges">JACK Bridges</span></h2>
<div class="level2">

<p>

Cadences main window integrates the control of a few &#039;JACK bridges&#039; -services which enable alternate Linux sound systems to run seemlessly atop JACK.
</p>

<p>
The ALSA audio bridge enables one or more ALSA audio applications to access your JACK device when it is started. Most everybody will want to ensure this is kept running alongside JACK as it enables audio for non-JACK apps such as Firefox. If you have chosen for JACK to start at boot then the ALSA audio bridge also gets started automatically.
</p>

<p>
The ALSA MIDI bridge needs to be running if you want to use any MIDI hardware.
</p>

<p>
PulseAudio is not included by default with KXStudio, and so the PulseAudio bridge will not function without PulseAudio.. Most applications which use PA also use ALSA directly so there is then no need for PA or the bridge. If needed for some reason, you can use PA with JACK via the bridge if PulseAudio is installed first.

</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 77
- 0
Documentation:Manual:downloading_and_booting_kxstudio.php View File

@@ -0,0 +1,77 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:downloading_and_booting_kxstudio");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "Downloading, booting and running KXStudio &#039;live&#039;");
include_once("includes/header.php");
?>

<div class="level1">

<p>

The easiest way to try KXStudio and discover if it supports your hardware is to boot it directly off a DVD or a USB drive. You can easily do this on any computer without any effect on the currently installed system. Doing this is referred to as running a &#039;live&#039; system.
</p>

</div>

<h2><span name="or_64_bit" id="or_64_bit">32 or 64 bit?</span></h2>
<div class="level2">

<p>

Download the KXStudio Live-DVD images from:
</p>

<p>
<a href="http://kxstudio.sourceforge.net/Downloads#LiveDVD" class="urlextern" title="http://kxstudio.sourceforge.net/Downloads#LiveDVD" rel="nofollow">http://kxstudio.sourceforge.net/Downloads#LiveDVD</a>
</p>

<p>
Note: the image files are .iso format (which is just the initials of the International Standards Organization which defined the format). These contain the complete KXStudio operating system as well as many applications.
</p>

<p>
You&#039;ll notice there are both 32 and 64-bit versions. Unless you are installing KXStudio to multiple, different machines you will only need one image file. If your machine allows for it, the 64-bit version is recommended as it usually works faster. Note that you can still run 32-bit software under a 64-bit installation but not the other way around.
</p>

<p>
With the exception of maybe a few (mainly Atom CPU-based) netbooks and tablets; most laptops, notebooks and desktops since the middle of the last decade will have a 64-bit capable CPU. One sure sign is if your machine is running a 64-bit version of Windows then you know you can run 64-bit KXStudio. If you&#039;re unsure, the easiest way to find out is just to try booting the 64-bit version. However, 64-bit machines can still use the 32-bit installation, so the 32-bit option is functional for all systems.
</p>

</div>

<h2><span name="dvd_or_usb_boot" id="dvd_or_usb_boot">DVD or USB boot?</span></h2>
<div class="level2">

<p>

If your machine has a DVD drive and you have a blank DVD to spare then the easiest way to boot KXStudio is to burn the .iso to a DVD. <a href="https://help.ubuntu.com/community/BurningIsoHowto" class="urlextern" title="https://help.ubuntu.com/community/BurningIsoHowto" rel="nofollow">Full instructions</a> are available for burning an iso file to a DVD under Windows, Mac, and GNU/Linux. Booting from a USB drive is faster than from DVD. Also, a USB drive can be set to save updates and work and function as a working system; but you won&#039;t experience the full speed and capacity of KXStudio until you install it to a hard drive.
</p>

<p>
If using USB, you will need a FAT32 formatted USB drive with at least 2 <acronym title="Gigabyte">GB</acronym> free space. You can then use the freely available <a href="http://unetbootin.sourceforge.net/" class="urlextern" title="http://unetbootin.sourceforge.net/" rel="nofollow">unetbootin</a> under Windows, OSX or Linux to transfer the iso file and make it boot from your USB drive. Using Unetbootin is as simple as selecting the &#039;Diskimage&#039; option, browsing to and selecting your downloaded KXStudio iso file, selecting the correct USB drive from the &#039;Drive&#039; drop-down menu and then clicking OK. After a few minutes wait you will be told when your USB drive is safe to be removed and ready to be booted.
</p>

</div>

<h2><span name="booting_kxstudio" id="booting_kxstudio">Booting KXStudio</span></h2>
<div class="level2">

<p>

Reboot your machine with the KXStudio DVD in the drive or with the unetbootin modified USB drive attached. In rare cases, your computer will automatically boot KXStudio. Typically, however, you will need to find out how to enter the boot menu on your machine or enter the BIOS or UEFI menu to change the boot order so that the DVD and/or USB drive takes higher boot priority than the hard drive. Commonly, pressing F12 right at start up will bring up the boot options; pressing F2 will bring up the full BIOS menu. In other cases, DELETE or ESCAPE are used. If none of these work, refer to the manual for your computer or search online for machine-specific instructions.
</p>

<p>
If you boot the DVD, you will first be prompted to choose the language to use. When this occurs, you can either do nothing and wait 30 seconds before the default of English is chosen and booting continues or you can use the arrow keys and ENTER to choose an alternate language. Booting off the USB via unetbootin does not bring up the language selection menu directly; instead you may change language settings under &#039;System Settings&#039;.

</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 160
- 0
Documentation:Manual:included_and_recommended_apps.php View File

@@ -0,0 +1,160 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:included_and_recommended_apps");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "Included and recommended apps");
include_once("includes/header.php");
?>

<div class="level1">

<p>

Listed below are recommended audio, video and productivity apps for GNU/Linux complete with a short description.
</p>

<p>
Many of these apps are, or will be, included on the KXStudio DVD. Those not included are easily installed from the repositories in most cases.
<br/>

</p>
<ul>
<li class="level1"><div class="li"> <strong>Amarok</strong> Feature-packed music player with support for syncing with ipods (up to 4th gen)</div>
</li>
<li class="level1"><div class="li"> <strong>Ardour</strong> The original Linux DAW</div>
</li>
<li class="level1"><div class="li"> <strong>Audacious</strong> Uncomplicated music player with good JACK support</div>
</li>
<li class="level1"><div class="li"> <strong>Audacity</strong> Popular cross-platform sound editor but with poor JACK support</div>
</li>
<li class="level1"><div class="li"> <strong>Avidemux</strong> Simple video editing and conversion tool ala Virtualdub</div>
</li>
<li class="level1"><div class="li"> <strong>Blender 3D</strong> Powerful 3D modelling, animation, rendering and compositing</div>
</li>
<li class="level1"><div class="li"> <strong>Cadence</strong> Controls and monitors various Linux sound systems</div>
</li>
<li class="level1"><div class="li"> <strong>cadence-jackmeter</strong> Cadence-JackMeter is a digital peak meter for JACK</div>
</li>
<li class="level1"><div class="li"> <strong>cadence-xycontroller</strong> Cadence-XY Controller is a simple XY widget that sends and receives data from Jack MIDI</div>
</li>
<li class="level1"><div class="li"> <strong>Carla</strong> Audio plugin host (LADSPA, LV2, VST etc)</div>
</li>
<li class="level1"><div class="li"> <strong>Catia</strong> Catia is a JACK Patchbay, with some neat features like A2J bridge support and JACK Transport</div>
</li>
<li class="level1"><div class="li"> <strong>cinepaint</strong> HDR, High bit-depth movie still editor</div>
</li>
<li class="level1"><div class="li"> <strong>Claudia</strong> Claudia is a LADISH frontend; it&#039;s just like Catia, but focused on session management through LADISH</div>
</li>
<li class="level1"><div class="li"> <strong>darktable</strong> Virtual lighttable and darkroom</div>
</li>
<li class="level1"><div class="li"> <strong>DeVeDe</strong> Creates DVD video and (S)VCD discs from movie files</div>
</li>
<li class="level1"><div class="li"> <strong>DIN (Din Is Noise)</strong> Advanced fluid microtonal synthesis with drones and melodic effects, oriented toward Indian classical music</div>
</li>
<li class="level1"><div class="li"> <strong>Dolphin</strong> The default KDE file manager</div>
</li>
<li class="level1"><div class="li"> <strong>Firefox</strong> The original and best web browser</div>
</li>
<li class="level1"><div class="li"> <strong>FileZilla</strong> (s)<acronym title="File Transfer Protocol">FTP</acronym> client (and server)</div>
</li>
<li class="level1"><div class="li"> <strong>GIMP</strong> GNU Image Manipulation Program - Photoshop alternative</div>
</li>
<li class="level1"><div class="li"> <strong>gnumeric</strong> A superior spreadsheet to the one included in LibreOffice or OpenOffice</div>
</li>
<li class="level1"><div class="li"> <strong>Guitarix</strong> JACK virtual guitar amplifier</div>
</li>
<li class="level1"><div class="li"> <strong>Handbrake</strong> Cross-platform DVD ripping and video transcoding</div>
</li>
<li class="level1"><div class="li"> <strong>Hydrogen</strong> JACK drum machine and sequencer, note: many additional drum-kits are available by installing the package “hydrogen-drumkits”</div>
</li>
<li class="level1"><div class="li"> <strong>IDJC</strong> Internet DJ Console is for live, web radio production. Features voip integration</div>
</li>
<li class="level1"><div class="li"> <strong>Inkscape</strong> Leading open source vector graphics editor</div>
</li>
<li class="level1"><div class="li"> <strong>JAmin</strong> JACK stereo audio mastering tool</div>
</li>
<li class="level1"><div class="li"> <strong>k3b</strong> CD, DVD and BD burning</div>
</li>
<li class="level1"><div class="li"> <strong>Kdenlive</strong> KDE video editor, similar to Sony Vegas</div>
</li>
<li class="level1"><div class="li"> <strong>ksnapshot</strong> Take screenshots of windows or desktops</div>
</li>
<li class="level1"><div class="li"> <strong>LibreOffice</strong> <acronym title="Microsoft">MS</acronym> Office-compatible word processor, spreadsheet and presentation suite</div>
</li>
<li class="level1"><div class="li"> <strong>LightWorks</strong> Professional, high-end video editor used in Hollywood productions (currently beta and 64-bit only)</div>
</li>
<li class="level1"><div class="li"> <strong>Lincoder</strong> Java/mencoder based batch video conversion tool</div>
</li>
<li class="level1"><div class="li"> <strong>Lingot</strong> Instrument tuner</div>
</li>
<li class="level1"><div class="li"> <strong>LMMS</strong> FruityLoops-esque sequencer w/ integrated synths</div>
</li>
<li class="level1"><div class="li"> <strong>mhwaveedit</strong> Lightweight sound editor with good JACK support</div>
</li>
<li class="level1"><div class="li"> <strong>Mixxx</strong> DJ mixing software</div>
</li>
<li class="level1"><div class="li"> <strong>MusE</strong> DAW with good MIDI editing features and some integrated plugins</div>
</li>
<li class="level1"><div class="li"> <strong>Musescore</strong> Professional quality music notation and scoring</div>
</li>
<li class="level1"><div class="li"> <strong>Mypaint</strong> Bitmap paint program that can simulate real painting techniques</div>
</li>
<li class="level1"><div class="li"> <strong>Okular</strong> <acronym title="Portable Document Format">PDF</acronym> and document viewer</div>
</li>
<li class="level1"><div class="li"> <strong>Paulstretch</strong> Ambient sound generation via stretched sound recordings, extreme stretch lenghts and many controls over the sound</div>
</li>
<li class="level1"><div class="li"> <strong>QDVDauthor</strong> DVD menu authoring</div>
</li>
<li class="level1"><div class="li"> <strong>Qsynth</strong> Allows use of SoundFont files</div>
</li>
<li class="level1"><div class="li"> <strong>Qsampler</strong> Allows use of sfz and gigasampler sample sets</div>
</li>
<li class="level1"><div class="li"> <strong>Qtractor</strong> Fast, lightweight DAW</div>
</li>
<li class="level1"><div class="li"> <strong>REAPER</strong> Powerful Windows-based DAW, officially supported under Wine</div>
</li>
<li class="level1"><div class="li"> <strong>Recorditnow</strong> Record your desktop to a video file</div>
</li>
<li class="level1"><div class="li"> <strong>Rakarrack</strong> JACK Guitar FX processor</div>
</li>
<li class="level1"><div class="li"> <strong>Rosegarden</strong> MIDI sequencer with integrated notation</div>
</li>
<li class="level1"><div class="li"> <strong>samplv1</strong> Simple sampler available as LV2 plugin and JACK app</div>
</li>
<li class="level1"><div class="li"> <strong>scribus</strong> Professional layout and publishing software</div>
</li>
<li class="level1"><div class="li"> <strong>smplayer</strong> Excellent audio and video playback app</div>
</li>
<li class="level1"><div class="li"> <strong>Soundkonverter</strong> batch audio file conversion</div>
</li>
<li class="level1"><div class="li"> <strong>Sooperlooper</strong> live looping sampler</div>
</li>
<li class="level1"><div class="li"> <strong>sunvox</strong> Advanced module tracker with integrated synths, samplers and JACK support</div>
</li>
<li class="level1"><div class="li"> <strong>Swami</strong> SoundFont editor</div>
</li>
<li class="level1"><div class="li"> <strong>synfig</strong> Powerful 2D vector animation software</div>
</li>
<li class="level1"><div class="li"> <strong>TAL-Noisemaker</strong> Superb sounding, fully automatable softsynth plugin</div>
</li>
<li class="level1"><div class="li"> <strong>VLC</strong> The famous VLC media player</div>
</li>
<li class="level1"><div class="li"> <strong>VMPK</strong> Virtual MIDI Piano Keyboard</div>
</li>
<li class="level1"><div class="li"> <strong>Wine</strong> Wine allows most <acronym title="Microsoft">MS</acronym> Windows software to run under GNU/Linux</div>
</li>
<li class="level1"><div class="li"> <strong>XCFA</strong> Another sound conversion tool with more options than soundkonverter</div>
</li>
<li class="level1"><div class="li"> <strong>XJadeo</strong> X JACK video monitor plays video in sync with a external time source (eg Ardour)</div>
</li>
<li class="level1"><div class="li"> <strong>Zynaddsubfx</strong> JACK synthesizer</div>
</li>
</ul>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 162
- 0
Documentation:Manual:installing_kxstudio.php View File

@@ -0,0 +1,162 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:installing_kxstudio");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "Installing KXStudio");
include_once("includes/header.php");
?>

<div class="level1">

<p>

There are a few important considerations you must be aware of before installing KXStudio. These include knowing what type of machine you are installing on, how its disks are to be arranged and whether or not you plan to boot any additional operating systems alongside KXStudio.
</p>

<p>
<strong>REMEMBER TO ALWAYS BACK UP</strong> all important files before you start modifying partitions or trying to install new operating systems!
</p>

</div>

<h2><span name="partitioning_options" id="partitioning_options">Partitioning options</span></h2>
<div class="level2">

<p>

Whether you are installing onto a UEFI or BIOS-based machine you will have the least trouble getting KXStudio to boot if you are able to let the KXstudio installer use your entire hard drive and automatically create the partitions for you. In any case, make sure that important files on the machine are backed up before installation in case you make a mistake during partitioning! It will also help to <a href="http://www.wikihow.com/Check-BIOS-Version" class="urlextern" title="http://www.wikihow.com/Check-BIOS-Version" rel="nofollow">know if your machine is UEFI or not before you start installing.</a>
</p>

<p>
If you want to install KXStudio onto the same drive as an existing installation of Windows <a href="https://help.ubuntu.com/community/HowtoResizeWindowsPartitions" class="urlextern" title="https://help.ubuntu.com/community/HowtoResizeWindowsPartitions" rel="nofollow">read this guide on how to resize your Windows drive</a>.
</p>

</div>

<h2><span name="uefi_windows_8_and_secureboot" id="uefi_windows_8_and_secureboot">UEFI, Windows 8 and SecureBoot</span></h2>
<div class="level2">

<p>

Many computers purchased since late 2011 use a technology called UEFI in place of the traditional BIOS to control and configure booting of operating systems. Due to UEFI being a new technology, GNU/Linux support is not yet as reliable as it is for older BIOS-based machines. In particular, Ubuntu and KXStudio cannot currently be dual-booted with Windows 8 with SecureBoot enabled without in-depth knowledge far beyond the scope of this guide. If you are hoping to dual boot Windows 8 with GNU/Linux you should look into disabling SecureBoot mode in your UEFI configuration.
</p>

</div>

<h2><span name="multi-booting_with_uefi" id="multi-booting_with_uefi">Multi-booting with UEFI</span></h2>
<div class="level2">

<p>

Those wishing to multi-boot Windows, OSX or other operating systems with KXStudio on a UEFI machine are recommended to obtain a copy of <a href="http://sourceforge.net/p/linux-secure/wiki/Home/" class="urlextern" title="http://sourceforge.net/p/linux-secure/wiki/Home/" rel="nofollow">Linux Secure Remix</a> before you attempt installing KXStudio. If, after installing KXStudio on the same UEFI machine as Windows or OSX and rebooting, you don&#039;t see a boot menu offering a choice of operating systems you should boot Linux Secure Remix and run the Boot-Repair tool which fixes most GRUB/UEFI boot configuration issues and should get your machine multi-booting properly. This tool may be included on future KXStudio DVD releases.
</p>

<p>
The Boot-Repair process is documented <a href="https://help.ubuntu.com/community/UEFI" class="urlextern" title="https://help.ubuntu.com/community/UEFI" rel="nofollow">here.</a> If Boot-Repair doesn&#039;t cure your UEFI booting woes it would be worth trying <a href="http://refit.sourceforge.net/" class="urlextern" title="http://refit.sourceforge.net/" rel="nofollow">rEFIt</a> or <a href="http://freedesktop.org/wiki/Software/gummiboot" class="urlextern" title="http://freedesktop.org/wiki/Software/gummiboot" rel="nofollow">gummiboot.</a>/
</p>

</div>

<h2><span name="advanced_partitioning_options" id="advanced_partitioning_options">Advanced partitioning options</span></h2>
<div class="level2">

<p>

By default, the main GNU/Linux system (root) uses the same partition as your user files (home). For various reasons, such as for ease of later system updates, you may want separate partitions. While ideal, this step is optional and can be skipped if you are uncomfortable with the details or want to save time.
</p>

<p>
To customize your partitions, run “GParted” from the KXStudio live session before running the KXStudio installer.

</p>
<ol>
<li class="level1"><div class="li"> First, resize existing systems that you want to keep, if you have any</div>
</li>
<li class="level1"><div class="li"> Create a new “extended” partition in the empty space</div>
</li>
<li class="level1"><div class="li"> Within the extended partition, make a logical partition for your root (/) of at least 15GB and formatted as ext4. This will contain the <acronym title="Operating System">OS</acronym> and apps.</div>
</li>
<li class="level1"><div class="li"> Also within the extended partition, make a small partition for swap (virtual RAM) that is at least as large as your physical RAM size and put it at the end of the drive</div>
</li>
<li class="level1"><div class="li"> Again within the extended partition, create a logical ext4 partition for home (/home) for all your user files and preferences. Use all the remaining space or consider making a separate partition for media files</div>
</li>
</ol>
<ul>
<li class="level1"><div class="li"> If your drive is large enough, you may keep extra space free to later create partitions for additional GNU/Linux systems on the same machine</div>
</li>
<li class="level1"><div class="li"> To read more about partitioning, such as how to format to share files between Linux and Windows or Mac, see <a href="https://help.ubuntu.com/community/DiskSpace" class="urlextern" title="https://help.ubuntu.com/community/DiskSpace" rel="nofollow">https://help.ubuntu.com/community/DiskSpace</a></div>
</li>
</ul>

</div>

<h2><span name="running_the_installer" id="running_the_installer">Running the installer</span></h2>
<div class="level2">

<p>

The KXStudio Live DVD is based upon Ubuntu 12.04 and uses the same installation tool so you can reference the <a href="https://help.ubuntu.com/community/GraphicalInstall" class="urlextern" title="https://help.ubuntu.com/community/GraphicalInstall" rel="nofollow">official Ubuntu Install guide.</a> The only real difference is in step 7 as you will need to click the &#039;Install KXStudio&#039; icon on the desktop instead of clicking &#039;Install Ubuntu&#039; when you are ready to run the installer.
</p>

<p>
Contrary to what the Ubuntu installer seems to recommend with its network check, it is recommended that you disconnect from the internet before and whilst you install KXStudio so that updates are not fetched and the process is completed as quickly as possible. After a successful install and reboot you will be prompted to install any available updates.
</p>

<p>
If you did the advanced partitioning to separate your root and home, choose “manual” for partitioning in the installer. Mark to use your intended root partition as / and your intended home partition as /home, keeping the ext4 format for both.
</p>

</div>

<h2><span name="kxstudio_welcome_setup" id="kxstudio_welcome_setup">KXStudio Welcome Setup</span></h2>
<div class="level2">

<p>

After installing and booting KXStudio for the first time, you will see the KXStudio Welcome screen. The design and options for this are being updated for the upcoming 12.04.2 release. This manual will include links or information to help guide your choices once the form of the welcome program is set. Until then you are safe to just accept its defaults if you are unsure what its options mean.
</p>

</div>

<h2><span name="multi-boot_issues_on_bios-based_machines" id="multi-boot_issues_on_bios-based_machines">Multi-boot issues on BIOS-based machines</span></h2>
<div class="level2">

<p>

Sometimes the installer fails to detect the operating systems and/or add the correct options to the GRUB boot menu ie no option to boot into Windows. To fix a boot menu on BIOS-based machines, it is usually sufficient to run:

</p>
<pre class="code">sudo update-grub
sudo grub-install /dev/sda</pre>

<p>

Type those commands into a terminal after booting into KXStudio and then reboot to check the new updated GRUB config. These commands make GRUB scan for other installed OSes, update its configuration and then write its updated configuration to the first HD which is /dev/sda.
</p>

<p>
<a href="http://www.supergrubdisk.org/super-grub2-disk/" class="urlextern" title="http://www.supergrubdisk.org/super-grub2-disk/" rel="nofollow">SuperGrubDisk2</a> is very useful for fixing GRUB boot issues as it allows for booting Linux partitions on UEFI machines as well as legacy BIOS machines even when GRUB is missing or incorrectly configured.
</p>

<p>
Another useful tool to ease GRUB2 configuration is <a href="https://launchpad.net/grub-customizer" class="urlextern" title="https://launchpad.net/grub-customizer" rel="nofollow">GRUB Customizer.</a>
</p>

</div>

<h2><span name="ssd_optimization" id="ssd_optimization">SSD optimization</span></h2>
<div class="level2">

<p>

The KXStudio installer does not tweak the configuration of Solid State Drives for optimal performance. Follow <a href="http://www.howtogeek.com/62761/how-to-tweak-your-ssd-in-ubuntu-for-better-performance/" class="urlextern" title="http://www.howtogeek.com/62761/how-to-tweak-your-ssd-in-ubuntu-for-better-performance/" rel="nofollow">this guide to optimize the performance of your SSD drives.</a>

</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 106
- 0
Documentation:Manual:jack_configuration.php View File

@@ -0,0 +1,106 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:jack_configuration");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "JACK Configuration");
include_once("includes/header.php");
?>

<div class="level1">

<p>

Most of JACK&#039;s important configuration options are set within the Driver tab of Cadence&#039;s JACK Settings window which you can access via Configure under Cadence&#039;s main window, as shown below:
</p>

<p>
<a href="http://kxstudio.sourceforge.net/screenshots/cadence-jacksettings2.png" class="media" title="cadence-jack-settings.png"><img src="http://kxstudio.sourceforge.net/screenshots/cadence-jacksettings2.png" class="media" title="JACK Settings" alt="JACK Settings" /></a>
</p>

</div>

<h2><span name="jack_driver" id="jack_driver">JACK Driver</span></h2>
<div class="level2">

<p>

The driver column to the left selects which JACK driver you wish to configure and use next time you start JACK with Cadence. Those using FireWire devices should use the FireWire driver but otherwise you should select ALSA for your JACK driver.
</p>

<p>
The top 3 drop-down options within Cadence&#039;s ALSA driver configuration are the most important as these let you select which device(s) to use for physical audio IO. If &#039;Duplex Mode&#039; is enabled then you can assign different ALSA devices to handle Input and Output individually. This could be useful, for example, if you need a mic input but wanted to have your sound output via a USB audio device that doesn&#039;t have a mic input. In this case you could use your computers ALSA device, which likely does have a mic input, as a separate input device. If Duplex Mode is not selected then the top drop-down is used to select the ALSA device to use for both audio input and output.
</p>

</div>

<h2><span name="jack_properties" id="jack_properties">JACK Properties</span></h2>
<div class="level2">

<p>

Sample Rate, Buffer Size and Periods/Buffer determine the base JACK latency. Their default values of 48000, 1024 and 2 respectively should work with most devices but a latency over 10ms is not usually considered good enough to be called realtime. Anyone interested in multitrack recording may wish to experiment with these settings to achieve the lowest, xrun-free latency their hardware will allow. It is possible to achieve 1ms latency with good hardware and the correct configuration.
</p>

<p>
<strong>Sample Rate</strong> Due to the way latency is calculated, it is recommended you use 48000 or 96000Hz for the lowest latency.
</p>

<p>
<strong>Buffer</strong> A smaller buffer gives lower latency. The lowest size most devices can handle is 64. Lower quality hardware may not handle any lower than 512.
</p>

<p>
<strong>Periods/Buffer</strong> The larger the period size, the higher the latency but the less chance of xruns. Experiment with using 2 or 3 periods/buffer.
</p>

<p>
<strong>Extra Latency</strong> To achieve the highest level of precision in overdubbing you should provide the extra latency values (in frames) which can be obtained with jack_iodelay. This process is covered in the Latency chapter.
</p>

</div>

<h2><span name="checking_for_errors_with_cadence-logs" id="checking_for_errors_with_cadence-logs">Checking for errors with cadence-logs</span></h2>
<div class="level2">

<p>

If JACK fails to start you can find out whats causing the problem by checking the Cadence logs. You can access the Cadence logs by launching it from under the &#039;Tools&#039; tab of the main Cadence window or you can run <strong>cadence-logs</strong> from a terminal.
</p>

</div>

<h2><span name="jack_and_firewire" id="jack_and_firewire">JACK and FireWire</span></h2>
<div class="level2">

<p>

kmix and alsamixer do not support FFADO. To adjust levels, enable phantom power and change other options for FireWire devices use ffado-mixer after you have started JACK with the FireWire driver. If you have trouble, running ffado-diag in a terminal may tell you more than Cadence&#039;s JACK error logs.
</p>

</div>

<h2><span name="rtirq_configuration" id="rtirq_configuration">rtirq configuration</span></h2>
<div class="level2">

<p>

This is an optional step that can help reduce latency. rtirq is a script that detects audio devices and prioritises them with the kernel according to a list specified in its configuration file. KXStudio&#039;s default rtirq configuration looks like:
</p>

<p>
RTIRQ_NAME_LIST=“firewire snd usb i8042”
</p>

<p>
Here we see FireWire devices have priority over ALSA and USB devices because its mentioned first. If you are mainly running JACK on a USB device you may wish to make usb the first item in the list by editing that line in the rtirq config file with a command such as:

</p>
<pre class="code">kdesudo kate /etc/default/rtirq</pre>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 118
- 0
Documentation:Manual:kxstudio_and_free_software.php View File

@@ -0,0 +1,118 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:kxstudio_and_free_software");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "KXStudio and Free Software");
include_once("includes/header.php");
?>

<div class="level1">

<p>

Along with its Ubuntu base and the whole GNU/Linux world, KXStudio has its roots in the <a href="http://www.gnu.org/philosophy/free-sw.html" class="urlextern" title="http://www.gnu.org/philosophy/free-sw.html" rel="nofollow">Free Software</a> movement led by Richard Stallman and the GNU project. All of the custom KXStudio tools are <acronym title="Free/Libre and Open Source Software">FLOSS</acronym>, as is the vast majority of other included software.
</p>

<p>
As KXStudio&#039;s primary purpose is to make the installation of a GNU/Linux-based audio/visual workstation as easy as possible, a few non-free additions are included where they assist that goal.
</p>

</div>

<h2><span name="non-free_software_from_ubuntu" id="non-free_software_from_ubuntu">Non-free software from Ubuntu</span></h2>
<div class="level2">

<p>

KXStudio is based upon Ubuntu which includes select non-free software. The Ubuntu non-free software is listed in separate repositories marked as either “non-free”, “restricted”, or “multiverse”. See <a href="https://help.ubuntu.com/community/Repositories" class="urlextern" title="https://help.ubuntu.com/community/Repositories" rel="nofollow">help.ubuntu.com/community/Repositories</a> for more information. Also, the standard Linux kernel includes some “binary blobs” — i.e. sections that have no source available (and so hamper the freedom to modify).
</p>

<p>
The main non-free software that KXStudio includes from Ubuntu is <strong>Flash Player</strong>. Many websites still, unfortunately, depend upon Adobe Flash, so Flash Player provides the smoothest user experience. Thankfully, the <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> standards Webm and HTML5 are becoming increasingly popular, and there is a <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> Flash-replacement called GNASH. Hopefully there will be less reason for the non-free Flash Player in the future.
</p>

<p>
Ubuntu also includes some non-free codecs for accessing proprietary file formats.
</p>

<p>
Some hardware manufacturers, particularly among wireless cards and graphics accelerators, do not make <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> drivers for Linux but create proprietary <strong>non-free drivers</strong>. <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> alternatives often function well enough, and KXStudio does not include proprietary drivers. However, because the proprietary drivers often provide superior performance, KXStudio includes a simple program to install them. See the separate page on <a href="<?php echo $ROOT; ?>/Documentation:Manual:video_drivers" class="wikilink1" title="video_drivers">installing non-free video drivers</a>.
</p>

</div>

<h2><span name="specific_kxstudio_non-free_software" id="specific_kxstudio_non-free_software">Specific KXStudio non-free software</span></h2>
<div class="level2">

<p>

While all KXStudio PPA listings are otherwise strictly <acronym title="Free/Libre and Open Source Software">FLOSS</acronym>, KXStudio includes non-free extras kept in a segregated repository. The packages are listed in Muon Package Manager <em>By Origin</em> under “KXStudio (Extra)”. In the software sources, the repository is “<a href="http://kxstudio.sourceforge.net/repo/" class="urlextern" title="http://kxstudio.sourceforge.net/repo/" rel="nofollow">http://kxstudio.sourceforge.net/repo/</a> precise free non-free”.
</p>

<p>
The KXStudio non-free repository includes the following:

</p>
<ul>
<li class="level1"><div class="li"> <strong>LightScribe support</strong> — LightScribe is a proprietary technology that uses specially made CDs and DVDs to allow users to burn direct-to-disc labels. </div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> <strong>LinuxDSP</strong> is a proprietary developer of quality Linux-native audio plugins. Most of the included plugins are limited demo versions, both proprietary and also not free of charge. The developer supports other <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> projects, however, and is active in the GNU/Linux audio community.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> <strong>Loomer</strong> is another developer of cross-platform proprietary audio plugins. They have ported several of their offerings to GNU/Linux. Aspect is among the most powerful Linux-native softsynths available. All Loomer plugins come as demos until a license is purchased.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> <strong>Pianoteq</strong> is a piano instrument synthesizer with exceptionally advanced features and sound quality. The included software also runs in demo mode until a license is purchased.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> <strong>REAPER</strong> is a Windows program that has official support to run in WINE. A fully native version for Linux is in the works although it will likely remain non-free. REAPER runs as a fully functional demo which simply reminds users to buy a modestly-priced license after a trial period. Many people coming from Mac or Windows may be familiar with REAPER and want to continue using it with KXStudio.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> <strong>Renoise</strong> is a Linux-native “tracker” style music production program. It has a dedicated user base and offers many features. The demo is functional with the exception of song and instrument rendering.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> <strong>SunVox</strong> is another Linux-native “tracker” style music program. It&#039;s known for being available for a wide range of platforms including Windows, Linux, Mac <acronym title="Operating System">OS</acronym> X, Windows Mobile, PalmOS, Maemo, Meego, iOS and Android. Although SunVox is proprietary, the desktop version used in KXStudio does not have any limitations.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> <strong>VST plugin support</strong> — The VST format is itself proprietary, but specific plugins may be either <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> or proprietary. VST plugins may be either Windows-based (these function via the Free Wine software) or Linux-native. Several <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> programs support VST plugins. All included VST plugins, whether <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> or proprietary, are in the non-free repository. You can also download Windows VSTs from internet sources and use them within KXStudio, although this is not officially supported.</div>
</li>
</ul>

</div>

<h2><span name="what_if_i_want_to_avoid_non-free_software" id="what_if_i_want_to_avoid_non-free_software">What if I want to avoid non-free software?</span></h2>
<div class="level2">

<p>

Specific non-free software can be manually uninstalled, see the instructions for <a href="<?php echo $ROOT; ?>/Documentation:Manual:package_management" class="wikilink1" title="package_management">package management</a>. Aside from the items listed above, another way to quickly identify a good portion of installed non-free software is to install the program <em>vrms</em>, the Virtual Richard M Stallman. Running vrms will bring up a list of non-free issues on your system, although it does not catch everything.
</p>

<p>
To remove non-free software from the package listings, choose “Configure Software Sources” under “Settings” in Muon Package Manager. There, you can uncheck the Proprietary drivers and multiverse (copyright or legally problematic) listings. On the “Other Software” tab, you can remove the Medibuntu and kxstudio.sourceforge.net repositories.
</p>

<p>
If you want to use strictly 100% Free Software, including even the strictly-<acronym title="Free/Libre and Open Source Software">FLOSS</acronym> Linux-libre kernel, consider <a href="http://trisquel.info/" class="urlextern" title="http://trisquel.info/" rel="nofollow">Trisquel</a>, which is based on Ubuntu yet is certified by the Free Software Foundation. You can then add the main KXStudio-Team PPAs following the same <a href="http://kxstudio.sourceforge.net/Documentation:Ubuntu:Upgrade" class="urlextern" title="http://kxstudio.sourceforge.net/Documentation:Ubuntu:Upgrade" rel="nofollow">instructions</a> as for other Ubuntu-based systems. Although this should work, it is not officially supported at this time.
</p>

<p>
There is also a long-term plan to potentially move the KXStudio repositories to Debian, which is more strictly <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> than Ubuntu (although still not FSF-approved because it provides a mechanism for users to install non-free software).

</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 65
- 0
Documentation:Manual:kxstudio_introduction.php View File

@@ -0,0 +1,65 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:kxstudio_introduction");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "KXStudio Introduction");
include_once("includes/header.php");
?>

<div class="level1">

</div>

<h2><span name="what_is_kxstudio" id="what_is_kxstudio">What is KXStudio?</span></h2>
<div class="level2">

<p>

KXStudio is a large and frequently updated collection of audio/visual software for GNU/Linux. KXStudio is also the name given to a freely distributed GNU/Linux distribution, currently based on Ubuntu. The full KXStudio includes many system tweaks, applications, and tools not found within common GNU/Linux operating systems (distributions). KXStudio makes it easy to set up and use a free software-based digital audio/visual production environment. As well as this primary goal, KXStudio comes prepared to perform a wide variety of common computing tasks.
</p>

</div>

<h2><span name="what_is_this_kxstudio_manual_for" id="what_is_this_kxstudio_manual_for">What is this KXStudio manual for?</span></h2>
<div class="level2">

<p>

This short manual was created for the KXStudio DVD or USB install. KXStudio works with pretty much any PC, laptop, or netbook with a suggested (but not absolute) minimum of 1GB RAM and 8GB free hard drive space. These instructions are written for newcomers to GNU/Linux operating systems. The intent is to provide an overview of both the installation process and a brief introduction to GNU/Linux audio/visual production applications including understanding and using the most important aspects of KXStudio&#039;s custom audio tools.
</p>

</div>

<h2><span name="who_created_kxstudio_and_for_what_purpose" id="who_created_kxstudio_and_for_what_purpose">Who created KXStudio and for what purpose?</span></h2>
<div class="level2">

<p>

As a distribution or <acronym title="Operating System">OS</acronym>, KXStudio is largely based upon Ubuntu which is one of the most popular variants of GNU/Linux. Ubuntu has a parent company called Canonical which has employees working on Ubuntu as well as the help of its large community of users and developers plus an increasing number of third party commercial software companies offering software or support for Ubuntu. Being based upon Ubuntu, KXStudio is compatible with Ubuntu software and resources.
</p>

<p>
Seeing a need for better audio/video integration in the system, a talented young Portuguese developer known online as falkTX decided to improve the management and ease of use of various audio sub-systems and related software. To reach that goal, he created the KXStudio project which is closely related to his Cadence suite of tools, the Carla plugin host, and the DISTRHO audio plugins. falkTX puts an incredible amount of time and effort into creating and supporting these and has also assisted in improving numerous other <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> projects. If you appreciate his ongoing hard work he would be grateful for any contributions you can make via <a href="http://kxstudio.sourceforge.net/Donations" class="urlextern" title="http://kxstudio.sourceforge.net/Donations" rel="nofollow">http://kxstudio.sourceforge.net/Donations</a> . Thank you!
</p>

</div>

<h2><span name="how_does_kxstudio_differ_from_ms_windows_or_mac_os_x" id="how_does_kxstudio_differ_from_ms_windows_or_mac_os_x">How does KXStudio differ from MS Windows or Mac OS X?</span></h2>
<div class="level2">

<p>

If you are familiar with <acronym title="Microsoft">MS</acronym> Windows or OSX already, please be aware that although KXStudio can, in most cases, fully replace these commercial operating systems, it is not intended as a drop-in replacement for either. It is possible to run many <acronym title="Microsoft">MS</acronym> Windows programs under GNU/Linux via a program called Wine, and both Mac OSX and Linux are variants of the UNIX family of operating systems, but the overall GNU/Linux experience is quite distinct. You will have to adjust to the GNU/Linux way of doing things if you want to run KXStudio. Don&#039;t worry about it though because both Windows and Mac users will discover many of their computer skills transfer easily over and getting help online is free and easy. The GNU/Linux community is very friendly and active, and you can directly converse with the makers of the software in a way that doesn&#039;t happen in the Windows and OSX world.
</p>

<p>
It is also important to note that not all hardware manufacturers support Linux yet so if you are buying any hardware especially for use with KXStudio you should do your research first. Don&#039;t presume that just because something works or doesn&#039;t work under Windows that it will be so under KXStudio. Linux has a few sore spots for hardware support that are mostly the fault of secretive, non-co-operative manufacturers, but, conversely, Linux also supports lots of older hardware that may not work at all with modern versions of Windows. See the <a href="<?php echo $ROOT; ?>/Documentation:Manual:useful_links_and_getting_help" class="wikilink1" title="useful_links_and_getting_help">Useful Links</a> section of this manual for various Linux hardware compatibility reference sites.
</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 128
- 0
Documentation:Manual:latency.php View File

@@ -0,0 +1,128 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:latency");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "Latency compensation and xrun reduction tips");
include_once("includes/header.php");
?>

<div class="level1">

</div>

<h2><span name="compensating_for_loopback_latency" id="compensating_for_loopback_latency">Compensating for loopback latency</span></h2>
<div class="level2">

<p>

Although latency mostly refers to buffer size which delays immediate feedback of input, there is additional latency due to the basic processing of your audio interface. There is no way to reduce this “loopback” latency, but its existence will affect the timing of recorded overdubs. To address this, you can tell programs what the delay amount is so that compensation can be made, i.e. the recorded audio will be adjusted in time to account for this delay. Software alone cannot discover what the loopback latency is, so the following procedure is needed to determine the amount of compensation required:
</p>

<p>
You will need a loopback cable capable of connecting your audio device&#039;s physical input to its physical output.
</p>

<p>
1 - Connect your (mic) input to your (headphone) output with the loopback cable
</p>

<p>
2 - Start JACK with known good settings
</p>

<p>
3 - Open a terminal and run jack_iodelay. It will print &#039;Signal below threshold…&#039; until we make the JACK connections
</p>

<p>
4 - Use Catia or Claudia to connect the system capture_1 to &#039;jack_delay in&#039; and connect &#039;jack_delay out&#039; to the system playback_1 port
</p>

<p>
5 - With both physical and JACK connections made, jack_iodelay should print output such as &#039;use X for the backend arguments -I and -O&#039;
</p>

<p>
6 - In the terminal, use ctrl-C to stop jack_iodelay
</p>

<p>
7 - In Cadence or Claudia, open the JACK settings and enter the value X from jack_iodelay for both the the input and output extra latency values
</p>

<p>
8 - Engage the new JACK settings with the “Switch Master” button. If you re-run the above test there should be no additional loopback latency.
</p>

<p>
This information is used to tell programs how to adjust recordings so that the recorded result will line up precisely with how the original performance aligned with the previous tracks.
</p>

<p>
Because these settings are not saved in the software to go with the interface choice, you&#039;ll need to change them every time you switch devices. The easiest way to do this is to have Claudia sessions for each device so all the settings are saved together.
</p>

</div>

<h2><span name="minimizing_xruns" id="minimizing_xruns">Minimizing xruns</span></h2>
<div class="level2">

</div>

<h3><a name="disable_wireless_internet_when_recording" id="disable_wireless_internet_when_recording">Disable wireless internet when recording</a></h3>
<div class="level3">

<p>

Wifi adapters have been known to cause random xruns. Some laptops have an external hardware switch to disable wifi. Otherwise, uncheck “enable wireless” in the KDE system tray&#039;s network control. If primarily using ethernet, consider disabling wifi (aka 802.11 a/b/g/n) in the BIOS or UEFI menu.
</p>

</div>

<h3><a name="close_browsers_when_recording" id="close_browsers_when_recording">Close browsers when recording</a></h3>
<div class="level3">

<p>

Many pop-up ads and popular web sites make use of Adobe Flash. If you have any browser tabs open, it only takes one to be using a little bit of Flash to cause a big loss of CPU, lower latency and more xruns. You should try to avoid running unnecessary, CPU intensive programs when recording.
</p>

</div>

<h3><a name="avoid_realtime_resampling" id="avoid_realtime_resampling">Avoid realtime resampling</a></h3>
<div class="level3">

<p>

When using Digital Audio Workstations and similar apps such as samplers etc, it is recommended you convert any sound files you wish to import to use the same sample rate as the one you are using for JACK. Many apps let you import and use sound files of different sample rates to the one you are running JACK with but then attempt to resample the audio &#039;on-the-fly&#039; and this leads to xruns if your CPU cannot keep up.
</p>

<p>
You can check the sample rate of audio files using your favourite media player such as smplayer (push CTRL+I when playing your file) or VLC (push CTRL+J) or you can find out from the terminal using mediainfo. soundkonverter and XCFA are good tools for batch conversion of audio files.
</p>

</div>

<h3><a name="check_for_irq_conflicts" id="check_for_irq_conflicts">Check for IRQ conflicts</a></h3>
<div class="level3">

<p>

Open a terminal and run:

</p>
<pre class="code">cat /proc/interrupts</pre>

<p>

Ensure that your audio driver is not sharing an IRQ with another device. Fixing this can be as simple as changing which port a USB audio device is using, but otherwise <a href="http://www.wiki.linuxmusicians.com/doku.php?id=system_configuration#solve_irq_conflict_by_unbinding_devices" class="urlextern" title="http://www.wiki.linuxmusicians.com/doku.php?id=system_configuration#solve_irq_conflict_by_unbinding_devices" rel="nofollow">see this guide to fixing IRQ conflicts.</a>

</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 67
- 0
Documentation:Manual:linux_audio_overview.php View File

@@ -0,0 +1,67 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:linux_audio_overview");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "Linux Audio Overview");
include_once("includes/header.php");
?>

<div class="level1">

<p>

Anyone intending to use GNU/Linux as a platform for audio or video production will benefit from understanding the primary Linux sound sub-systems, their purposes and limitations.
</p>

</div>

<h2><span name="alsa" id="alsa">ALSA</span></h2>
<div class="level2">

<p>

<a href="http://www.alsa-project.org" class="urlextern" title="http://www.alsa-project.org" rel="nofollow">ALSA</a>, the Advanced Linux Sound Architecture, is a collection of drivers and libraries that provide Linux with audio and MIDI support for onboard, PCI, and USB audio hardware. ALSA doesn&#039;t support FireWire audio devices — that requires FFADO and JACK (see below).
</p>

<p>
ALSA alone is insufficient for most AV production tasks because only one application can access an ALSA device at any one time. JACK and Pulseaudio were created mainly to overcome this restriction although they target different use cases. KXStudio includes an ALSA/JACK bridge program called “snd-aloop daemon” which enables the user to run ALSA-only apps alongside JACK and other JACK-native software. This bridge is turned on by default when JACK is started - see the <a href="http://www.wiki.linuxmusicians.com/doku.php?id=cadence_introduction" class="urlextern" title="http://www.wiki.linuxmusicians.com/doku.php?id=cadence_introduction" rel="nofollow">Cadence</a> instructions for more information.
</p>

</div>

<h2><span name="jack" id="jack">JACK</span></h2>
<div class="level2">

<p>

The <a href="http://jackaudio.org" class="urlextern" title="http://jackaudio.org" rel="nofollow">JACK Audio Connection Kit</a> is a program (jackd aka the JACK server) and a protocol/<acronym title="Application Programming Interface">API</acronym> that enables the connection of a number of different applications to an audio device as well as allowing them to share audio and/or MIDI data between themselves. JACK applications may be connected on the same machine or remotely over a network. Think of JACK as a virtual audio patch panel, like on a physical mixing desk. While making these connections is not always automatic, the JACK system provides unparalleled flexibility for combining different tools in whatever way you wish. JACK has become the pro-audio application interconnection standard under GNU/Linux and is becoming increasingly popular on other platforms.
</p>

</div>

<h2><span name="ffado" id="ffado">FFADO</span></h2>
<div class="level2">

<p>

<a href="http://ffado.org/" class="urlextern" title="http://ffado.org/" rel="nofollow">FFADO</a> provides Free FireWire Audio Drivers (the “O” is for .Org). Unlike ALSA, FFADO depends upon JACK and does not work independently. Hence, when you select a FireWire audio device for use by JACK under the Cadence driver configuration, you are using the FFADO drivers.
</p>

</div>

<h2><span name="pulseaudio" id="pulseaudio">PulseAudio</span></h2>
<div class="level2">

<p>

<a href="http://pulseaudio.org" class="urlextern" title="http://pulseaudio.org" rel="nofollow">PulseAudio</a> (PA) is a sound server which, like JACK, runs on top of ALSA to provide functions such as allowing more than one application to use an ALSA device simultaneously. Pulse is targetted at regular desktop and mobile users rather than low-latency audio production. Cadence includes a PulseAudio/JACK bridge enabling you to run PulseAudio apps under JACK, but there are very few apps which support PA without supporting JACK or ALSA. KXStudio does not include PulseAudio as part of the default installation, but it is easily installed with the package manager if required.

</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 161
- 0
Documentation:Manual:package_management.php View File

@@ -0,0 +1,161 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:package_management");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "Package Management");
include_once("includes/header.php");
?>

<div class="level1">

<p>

In GNU/Linux, a “package” is a compressed file that usually contains a program or program data. The process of installing and removing software from packages is called package management.
</p>

<p>
KXStudio is based upon Ubuntu which is itself based on Debian GNU/Linux, so as a result KXStudio uses .deb packages along with the Ubuntu software repositories (repos). The KXStudio part is the pre-configured PPA&#039;s (Personal Package Archives) which supplement the Ubuntu repositories.
</p>

<p>
In KXStudio 12.04.2, the main package manager is called <strong>Muon</strong>. Muon is the easiest way to manage your software under KXStudio. KXStudio previously used the Synaptic package manager instead but these instructions largely apply to that as well.
</p>

</div>

<h2><span name="system_upgrade" id="system_upgrade">System Upgrade</span></h2>
<div class="level2">

<p>

For increased system stability and security, it is recommended you keep all packages up-to-date. If your machine was not connected to the internet when you installed KXStudio, then the first thing you should do after installation is connect to the internet to perform a system upgrade. Note: you can always browse and remove packages from Muon but performing a system upgrade or installing new software from the repositories requires an internet connection.
</p>

<p>
Muon Update Manager is a simple program which automatically checks for and alerts you about updates. There will be an icon in the system tray to show you when updates are available.
</p>

<p>
If you want to manually check for updates, first open Muon Update Manager or instead the full Muon Package Manager, then click &#039;Check for updates&#039;. After it has finished checking for updates, it will tell you in the status bar at the bottom of its window how many upgradeable packages are available. If there are any updates, click &#039;Full Upgrade&#039; then &#039;Apply Changes&#039;. It will then ask you for your password before upgrading the system to the latest package versions.
</p>

<p>
Most programs will be ready as soon as updating has finished. In the case of some packages, such as the kernel, you will have to reboot before your updates can take effect.
</p>

</div>

<h2><span name="installing_packages" id="installing_packages">Installing packages</span></h2>
<div class="level2">

<p>

There are two main ways to install a package. If the program you want is available from the repositories it is recommended you install it from there. Not only is that easier than having to find a standalone package, you can trust it more and it will get automtically updated when you do a system update, after an update becomes available.
</p>

</div>

<h3><a name="installing_packages_via_muon" id="installing_packages_via_muon">Installing packages via Muon</a></h3>
<div class="level3">

<p>

Start Muon Package Manager, then type either the name of the program you want or search using a descriptive term.
</p>

<p>
When you have found the package you want, select it by clicking and then press the &#039;Mark for Installation&#039; button in the package details tab below or right-click the listing itself and choose &#039;Mark for installation&#039;.
</p>

<p>
If the chosen app requires additional packages be installed for it to funtion, then you will be asked to confirm the installation of the required additional packages. These extra packages are referred to as <em>dependencies</em>, and most reasonably complex programs have multiple dependencies. You can proceed to mark additional packages for installation and whenever you are ready install click &#039;Apply Changes&#039; in the toolbar at the top. Muon will then ask you for your password before it downloads and installs the requested packages.
</p>

<p>
If you install a graphical application you should be able to find and run it by typing the program name in the KDE menu search box.
</p>

</div>

<h3><a name="installing_from_a_.deb_package_file" id="installing_from_a_.deb_package_file">Installing from a .deb package file</a></h3>
<div class="level3">

<p>

There are many reasons why you should always try to install software from the repositories (or PPA&#039;s) rather than from .deb package files. Aside from saving time, using repositories ensures you are getting the correct packages for your distribution and will be automatically updated. In some cases, a .deb file will automatically install a repository to keep things updated, but not always. You will normally want to find repository versions or add PPA&#039;s to get software.
</p>

<p>
Confusingly, there are multiple version of Ubuntu, many packages are available in 32- or 64-bit flavours. When installing software that is only available in .deb packages (named from Ubuntu&#039;s parent distro called Debian), look for the option that best matches your installed system. KXStudio is based upon Ubuntu 12.04 (codenamed Precise) so it is compatible with packages made for that distribution. Make sure you get the 32- or 64-bit package as appropriate. The main Cadence window tells you if you are running a 32 bit (aka i386 or i686) or 64 bit (amd64) system.
</p>

<p>
Finding the correct package version is often the hardest part of installing from a .deb package. Installation is then straightforward enough. Firefox may be set to automatically open the installer when the file is downloaded or you can double-click the .deb package in the Firefox Downloads window to start installation. Otherwise, open Dolphin (the file manager), find the package you want to install and left click on it once. This opens the package with a program called gdebi-kde which will present you with an &#039;Install Package&#039; icon you must click to install the package. What usually happens is you will be prompted for your password, and then you may find you will need to click &#039;Install Package&#039; a second time before the package gets installed.
</p>

</div>

<h2><span name="removing_packages" id="removing_packages">Removing packages</span></h2>
<div class="level2">

<p>

In Muon, search for the package you wish to remove then select &#039;Removal&#039; or &#039;Purge&#039; from the “Mark for:” option within the package details tab or choose the corresponding option by right clicking on a package listing. If the program is already installed, the options will be either &#039;Mark for Removal&#039; which simply removes the package or &#039;Mark for Purge&#039; which also removes the programs settings. After having found and selected all the packages you wish to remove click &#039;Apply Changes&#039;. You will then be prompted for your password.
</p>

</div>

<h2><span name="removing_unneeded_dependencies" id="removing_unneeded_dependencies">Removing unneeded dependencies</span></h2>
<div class="level2">

<p>

Removing a package will not remove the dependencies which may have been installed with it. To remove such extra packages if nothing else installed requires them, within Muon Package Manager, go to the Edit menu and choose “Remove unnecessary packages.” Then, as with all other procedures, you will have to click “Apply Changes” and enter your password.
</p>

</div>

<h2><span name="adding_further_personal_package_archives_ppa_s" id="adding_further_personal_package_archives_ppa_s">Adding further Personal Package Archives (PPA&#039;s)</span></h2>
<div class="level2">

<p>

The KXStudio repositories are themselves PPA&#039;s. In some cases, you may want to add new PPA&#039;s to your system.
</p>

<p>
PPA&#039;s are especially useful if you want to help do beta testing or try pre-release versions of programs. In other cases, such as for KXStudio, PPA&#039;s supply stable releases that aren&#039;t maintained or up-to-date in the main system repositories. Installing from a PPA is easier and recommended in most cases over installing from .deb packages or compiling from source.
</p>

<p>
If a PPA is available, it will be listed either on a software&#039;s website or their Launchpad.net page. For example, the latest stable release of LibreOffice isn&#039;t in the main repositories because it hasn&#039;t had completely thorough testing under this version of Ubuntu. LibreOffice offers a PPA for the stable version and another for beta testing. The address for the stable PPA is: ppa:libreoffice/ppa
</p>

<p>
To add the new PPA, open Muon and choose “Configure Software Sources” from the “Settings” menu then enter your password. In the window that appears, choose the tab “Other Software”. Click the “Add…” button and enter the PPA&#039;s address.
</p>

<p>
The maintainers of each PPA will keep your software up-to-date, so you only need to install it once. Then, after an update check in Muon, the packages will be listed for update or available for installation if no previous version was installed.
</p>

</div>

<h2><span name="repair_broken_packages" id="repair_broken_packages">Repair broken packages</span></h2>
<div class="level2">

<p>

If a package installation fails or you have package management issues such as being unable to install additional packages due to unresolved dependencies then try running one (or both) of the following commands from a terminal, such as Konsole

</p>
<pre class="code">sudo apt-get install -f
sudo dpkg --configure -a</pre>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 92
- 0
Documentation:Manual:simple_claudia_studio.php View File

@@ -0,0 +1,92 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:simple_claudia_studio");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "Creating a simple LADISH studio using Claudia");
include_once("includes/header.php");
?>

<div class="level1">

<p>

JACK enables complex routing of audio and MIDI data between JACK-enabled apps. This enables the user to create their own custom instruments or virtual studios by combining several JACK apps. However, having such power would be of limited use if you had to manually patch programs together every time you wanted a specific configuration. This problem is addressed by JACK session managers such as LADISH.
</p>

<p>
KXStudio includes an app called Claudia which uses the LADISH JACK session management standard to save and restore JACK configurations or &#039;LADISH Studios&#039;. Claudia is one of two JACK patchbay apps included in KXStudio for making and removing JACK connections. The other app is Catia, a simpler program with no canvas preview and no saved connections (and available for Windows and OSX, unlike Claudia).
</p>

<p>
The use of Claudia and LADISH is best demonstrated with a simple example scenario. Let&#039;s say that you frequently find yourself wanting to record audio from a non-JACK app such as Firefox and you use qtractor to record the audio. To do this you must ensure JACK and Cadence&#039;s ALSA audio bridge are running and you must connect the alsa2jack capture ports to qtractor&#039;s JACK inputs. In this guide we will create a simple LADISH studio with Claudia that will start JACK and the ALSA bridges, load qtractor and connect alsa2jack to its inputs so its ready to record from Firefox at boot.
</p>

</div>

<h2><span name="creating_a_ladish_studio" id="creating_a_ladish_studio">Creating a LADISH studio</span></h2>
<div class="level2">

<p>

Before you can create a LADISH studio, you need to ensure that you can start JACK OK, ideally without any xruns. If JACK isn&#039;t already running then Claudia will try to automatically start JACK using the current JACK settings, which it shares with Cadence, when you start a studio but it will fail if your JACK settings aren&#039;t correct. See the previous &#039;An introduction to Cadence&#039; and &#039;JACK Configuration&#039; chapters for tips on setting up JACK.
</p>

<p>
Claudia&#039;s interface is divided into four main areas when a studio is loaded. The menus and controls are along the top, a studio and room list is displayed to the upper left, a canvas preview on the lower left (when a studio is loaded) then the currently selected studio occupies the rest of Claudia&#039;s window. Claudia may automatically create a new studio when you launch it, otherwise the main canvas will be blank save for some instructions to help you get started with creating a studio. As these instructions state, you can create a new LADISH studio by selecting &#039;New Studio&#039; from Claudia&#039;s studio menu. You can call the studio anything you want but I&#039;ll just use &#039;qtractor&#039; for the studio name.
</p>

</div>

<h2><span name="start_jack_and_the_alsa_bridge" id="start_jack_and_the_alsa_bridge">Start JACK and the ALSA bridge</span></h2>
<div class="level2">

<p>

If you&#039;ve not already got JACK running, then now is a good time to start it. You can either start JACK from Cadence, choose &#039;Start Studio&#039; from Claudia&#039;s studio menu or push F5 in Claudia. When you do this, you will notice Claudia&#039;s transport controls become available and at least two items appear on the studio canvas - the JACK &#039;Hardware Capture&#039; and &#039;Hardware Playback&#039; ports. These are only visible in Claudia when the JACK server is running. For the purposes of this example we also need the Cadence ALSA audio bridge to be running. When you have the ALSA audio bridge running you will see an extra two items (JACK clients) in Claudia&#039;s studio editing area- alsa2jack, which gets auto-connected to the Hardware Playback ports, and jack2alsa which gets auto-connected to the Hardware capture ports.
</p>

</div>

<h2><span name="adding_an_app_to_a_studio" id="adding_an_app_to_a_studio">Adding an app to a studio</span></h2>
<div class="level2">

<p>

Now we shall add qtractor into our studio by choosing &#039;Add New…&#039; from the application menu, selecting qtractor under the DAW tab of the Claudia launcher then choosing OK. This will launch qtractor and add it into our studio. You may want to minimise or move qtractor to a different virtual desktop for the moment if you only have a small display as we are still working within Claudia; where you should now see a new JACK client box for qtractor within the editor as well as a new item, called Qtractor, added to the studio list.
</p>

</div>

<h2><span name="making_jack_connections" id="making_jack_connections">Making JACK connections</span></h2>
<div class="level2">

<p>

We want this studio to automatically connect the outputs of alsa2jack (which outputs the sound of all non-JACK apps, such as Firefox) into qtractor so we must connect one to the other. Left-click on capture_1 within the alsa2jack box then, keeping the mouse button pressed, drag your pointer over the Master/in_1 input of qtractor, then let go. You should then see a blue line connecting the alsa2jack client to qtractor&#039;s input port - this indicates you have created a JACK connection between the two. Now do the same for alsa2jack&#039;s capture_2 and qtractor&#039;s Master/in_2 so that both the left and right channels will get sent from ALSA to qtractor. Finally, connect qtractor&#039;s Master/out_1 and Master/out_2 to the Hardware Playback ports so that you can hear qtractors output. That completes our studio configuration so save the studio, which should look something like this:
</p>

<p>
<a href="http://kxstudio.sourceforge.net/screenshots/claudia-qtractor.png" class="media" title="claudia2.png"><img src="http://kxstudio.sourceforge.net/screenshots/claudia-qtractor.png" class="media" title="Simple Claudia Studio example config" alt="Simple Claudia Studio example config" /></a>
</p>

</div>

<h2><span name="loading_a_studio_at_boot" id="loading_a_studio_at_boot">Loading a studio at boot</span></h2>
<div class="level2">

<p>

Cadence can automatically load a Claudia studio at system launch if you like. This should probably be avoided if you are using a system in which your studio&#039;s audio device is not always connected.
</p>

<p>
To set a studio to auto-load, go to the main Cadence window, check that &#039;Auto-start JACK or LADISH at login&#039; is ticked, and then click on the three dots to the right of this text. Choose &#039;Load LADISH studio&#039;, select the just-created qtractor studio and then push OK. Next time you reboot you should find JACK starts using the settings saved within your studio, qtractor loads automatically and if you open Claudia (or Catia) you should see alsa2jack is connected to qtractor.
</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 232
- 0
Documentation:Manual:useful_links_and_getting_help.php View File

@@ -0,0 +1,232 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:useful_links_and_getting_help");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "Useful Links And Getting Help");
include_once("includes/header.php");
?>

<div class="level1">

</div>

<h2><span name="useful_links" id="useful_links">Useful Links</span></h2>
<div class="level2">

</div>

<h3><a name="kxstudio" id="kxstudio">KXStudio</a></h3>
<div class="level3">

<p>

For more info on the KXStudio applications such as Cadence, Claudia and Catia
</p>

<p>
<a href="http://kxstudio.sourceforge.net/Applications" class="urlextern" title="http://kxstudio.sourceforge.net/Applications" rel="nofollow">http://kxstudio.sourceforge.net/Applications</a>
</p>

</div>

<h3><a name="hardware_compatibility" id="hardware_compatibility">Hardware Compatibility</a></h3>
<div class="level3">

<p>

To check to see if your sound device is supported by GNU/Linux, check the ALSA SoundCard Matrix
</p>

<p>
<a href="http://www.alsa-project.org/main/index.php/Matrix:Main" class="urlextern" title="http://www.alsa-project.org/main/index.php/Matrix:Main" rel="nofollow">http://www.alsa-project.org/main/index.php/Matrix:Main</a>
</p>

<p>
If you have a FireWire audio device you will want to check the status of your device in the FFADO Device support database
</p>

<p>
<a href="http://www.ffado.org/?q=devicesupport/list" class="urlextern" title="http://www.ffado.org/?q=devicesupport/list" rel="nofollow">http://www.ffado.org/?q=devicesupport/list</a>
</p>

<p>
Another good resource for GNU/Linux audio hardware compatibility is the linuxaudio.org Current Audio Gear page
</p>

<p>
<a href="http://wiki.linuxaudio.org/wiki/current_audio_gear" class="urlextern" title="http://wiki.linuxaudio.org/wiki/current_audio_gear" rel="nofollow">http://wiki.linuxaudio.org/wiki/current_audio_gear</a>
</p>

<p>
To check for the compatibility of your printer with the GNU/Linux printing system, CUPS, check the OpenPrinting database
</p>

<p>
<a href="http://www.openprinting.org/printers" class="urlextern" title="http://www.openprinting.org/printers" rel="nofollow">http://www.openprinting.org/printers</a>
</p>

</div>

<h3><a name="gnu_linux_software_resources" id="gnu_linux_software_resources">GNU/Linux software resources</a></h3>
<div class="level3">

<p>

The Ubuntu package archive search
</p>

<p>
<a href="http://packages.ubuntu.com/" class="urlextern" title="http://packages.ubuntu.com/" rel="nofollow">http://packages.ubuntu.com/</a>
</p>

<p>
The linuxaudio.org wiki has a comprehensive list of all GNU/Linux audio and sound software
</p>

<p>
<a href="http://wiki.linuxaudio.org/apps/start" class="urlextern" title="http://wiki.linuxaudio.org/apps/start" rel="nofollow">http://wiki.linuxaudio.org/apps/start</a>
</p>

<p>
Libre Graphics World provides news and other resources relating to free graphics software
</p>

<p>
<a href="http://libregraphicsworld.org/" class="urlextern" title="http://libregraphicsworld.org/" rel="nofollow">http://libregraphicsworld.org/</a>
</p>

<p>
Freecode maintains the Web&#039;s largest index of GNU/Linux software
</p>

<p>
<a href="http://freecode.com/" class="urlextern" title="http://freecode.com/" rel="nofollow">http://freecode.com/</a>
</p>

<p>
The Wine Application Database (AppDB) details the compatibility of Windows programs with Wine
</p>

<p>
<a href="http://appdb.winehq.org/" class="urlextern" title="http://appdb.winehq.org/" rel="nofollow">http://appdb.winehq.org/</a>
</p>

</div>

<h3><a name="recommended_tutorials_and_guides" id="recommended_tutorials_and_guides">Recommended tutorials and guides</a></h3>
<div class="level3">

<p>

To get the most out of Linux, you need to understand how to use the terminal (aka console). Here&#039;s the Ubuntu beginners guide to using the terminal
</p>

<p>
<a href="https://help.ubuntu.com/community/UsingTheTerminal" class="urlextern" title="https://help.ubuntu.com/community/UsingTheTerminal" rel="nofollow">https://help.ubuntu.com/community/UsingTheTerminal</a>
</p>

<p>
KXStudio uses the KDE Desktop Environment by default. Here is an introduction to the KDE 4 Plasma desktop
</p>

<p>
<a href="http://userbase.kde.org/Plasma" class="urlextern" title="http://userbase.kde.org/Plasma" rel="nofollow">http://userbase.kde.org/Plasma</a>
</p>

<p>
JACK was created mainly for Ardour which remains the most popular open source DAW. Sadly its not the most intuitive app ever so you may want to read its manual
</p>

<p>
<a href="http://manual.ardour.org/" class="urlextern" title="http://manual.ardour.org/" rel="nofollow">http://manual.ardour.org/</a>
</p>

<p>
Those who prefer the more lightweight DAW qtractor will be happy to hear it has one of the best free manuals available for a GNU/Linux app
</p>

<p>
<a href="http://downloads.sourceforge.net/qtractor/qtractor-0.5.x-user-manual.pdf" class="urlextern" title="http://downloads.sourceforge.net/qtractor/qtractor-0.5.x-user-manual.pdf" rel="nofollow">http://downloads.sourceforge.net/qtractor/qtractor-0.5.x-user-manual.pdf</a>
</p>

</div>

<h2><span name="getting_help" id="getting_help">Getting Help</span></h2>
<div class="level2">

<p>

Remember that KXStudio the distribution is based upon Ubuntu 12.04 aka Precise so any instructions or software you find for Ubuntu (precise) will be compatible with KXStudio.
</p>

</div>

<h3><a name="fora_and_wikis" id="fora_and_wikis">Fora and wikis</a></h3>
<div class="level3">

<p>

If you get stuck, the first place to search for a solution is on the KXStudio forum
</p>

<p>
<a href="http://linuxmusicians.com/viewforum.php?f=47" class="urlextern" title="http://linuxmusicians.com/viewforum.php?f=47" rel="nofollow">http://linuxmusicians.com/viewforum.php?f=47</a>
</p>

<p>
If you suspect its more of a general Ubuntu issue it would be a good idea to search for help on the Ubuntu fora too
</p>

<p>
<a href="http://ubuntuforums.org" class="urlextern" title="http://ubuntuforums.org" rel="nofollow">http://ubuntuforums.org</a>
</p>

<p>
The LinuxMusicians wiki contains all sorts of useful info for Linux audio users, including this manual
</p>

<p>
<a href="http://www.wiki.linuxmusicians.com" class="urlextern" title="http://www.wiki.linuxmusicians.com" rel="nofollow">http://www.wiki.linuxmusicians.com</a>
</p>

</div>

<h3><a name="irc" id="irc">IRC</a></h3>
<div class="level3">

<p>

If you can&#039;t find an answer to your question on the fora or with your favourite search engine, <acronym title="Internet Relay Chat">IRC</acronym> is going to be your best hope of getting help quickly.
</p>

<p>
KXStudio includes the <strong>Konversation</strong> KDE <acronym title="Internet Relay Chat">IRC</acronym> client which you can use to connect to the following channels on irc.freenode.net
</p>

<p>
<strong>#kxstudio</strong> is the official <acronym title="Internet Relay Chat">IRC</acronym> support channel for KXStudio
</p>

<p>
<strong>#opensourcemusicians</strong> is the <acronym title="Internet Relay Chat">IRC</acronym> channel of the open source musicians podcast
</p>

<p>
<strong>#ardour</strong> has its own official <acronym title="Internet Relay Chat">IRC</acronym> support channel on freenode.net as do many other popular open source projects
</p>

<p>
<strong>#kde</strong> is good for general issues with using the K Desktop
</p>

<p>
<strong>#ubuntu</strong> is the support channel for general Ubuntu system issues
</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 87
- 0
Documentation:Manual:video_drivers.php View File

@@ -0,0 +1,87 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:video_drivers");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "Installing non-free video drivers");
include_once("includes/header.php");
?>

<div class="level1">

<p>

The majority of modern day PC hardware uses display technology from either Nvidia, ATI/AMD, or Intel.
</p>

<p>
Intel drivers are open source but the official Nvidia and ATI/AMD drivers are proprietary. Fresh KXStudio installations include official drivers for Intel video but only unofficial drivers for Nvidia and ATI/AMD. The official Nvidia or ATI/AMD drivers are easily added if required, and they often provide superior performance (especially for OpenGL 3D and gaming), extra or more complete features, and better power management.
</p>

</div>

<h2><span name="what_type_of_video_hardware_do_i_have" id="what_type_of_video_hardware_do_i_have">What type of video hardware do I have?</span></h2>
<div class="level2">

<p>

If you&#039;re unsure what vendor or model video hardware you have installed in your machine, open a terminal (such as Konsole) and type:

</p>
<pre class="code">lspci</pre>

<p>

lspci will &#039;List PCI&#039; hardware installed on your machine, including your video device - the make and model of which is listed as being a &#039;VGA compatible controller&#039;. If it is a Nvidia or ATI/AMD device then you may want to switch to the non-free driver, if its available for your hardware, to take advantage of the extra features and better performance.
</p>

</div>

<h2><span name="using_the_additional_drivers_tool" id="using_the_additional_drivers_tool">Using the &#039;Additional Drivers&#039; tool</span></h2>
<div class="level2">

<p>

The &#039;Additional Drivers&#039; tool can be used to simplify the process of downloading and installing or removing non-free video drivers. It requires that you are connected to the internet for it to fetch the requested drivers. From the KX Studio desktop menu you can find it under the Applications → System sub-menu or you may find it easier to search for it.
</p>

<p>
When you run the Additional Drivers tool it will check the type of video hardware you have before presenting a new window in which you will see a list of compatible drivers, if any are available. You may be presented with more than one suitable driver but it&#039;s safe to use the recommended version if you&#039;re unsure which version of the driver is best for you. Select a driver, then click &#039;Activate&#039; which will then download and install the new driver. The new driver will not take effect until you have rebooted.
</p>

</div>

<h2><span name="nvidia_video_fixes_and_tweaks" id="nvidia_video_fixes_and_tweaks">Nvidia video fixes and tweaks</span></h2>
<div class="level2">

<p>

To enable the screen brightness control keys and disable the NVIDIA boot logo on my NVIDIA-using laptop using the non-free nvidia driver I had to create a file located at /usr/share/X11/xorg.conf.d/10-nvidia-brightness.conf containing:

</p>
<pre class="code">Section &quot;Device&quot;
Identifier &quot;Device0&quot;
Driver &quot;nvidia&quot;
VendorName &quot;NVIDIA Corporation&quot;
BoardName &quot;GeForce 8600M&quot;
Option &quot;RegistryDwords&quot; &quot;EnableBrightnessControl=1&quot;
Option &quot;NoLogo&quot; &quot;true&quot;
EndSection</pre>

</div>

<h2><span name="additional_amd_issues" id="additional_amd_issues">Additional AMD issues</span></h2>
<div class="level2">

<p>

For thorough information about the proprietary AMD drivers, including how to install more up-to-date drivers or how to remove the proprietary drivers and return to the <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> ones, see the community wiki: <a href="http://wiki.cchtml.com/" class="urlextern" title="http://wiki.cchtml.com/" rel="nofollow">wiki.cchtml.com</a>

</p>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 117
- 0
Documentation:Manual:wineasio_and_reaper.php View File

@@ -0,0 +1,117 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Manual:wineasio_and_reaper");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Manual", "WineASIO and REAPER");
include_once("includes/header.php");
?>

<div class="level1">

</div>

<h2><span name="what_is_wine" id="what_is_wine">What is Wine?</span></h2>
<div class="level2">

<p>

KXStudio includes a program called Wine (Wine Is Not an Emulator) which allows most <acronym title="Microsoft">MS</acronym> Windows software to run under GNU/Linux. It is <acronym title="Free/Libre and Open Source Software">FLOSS</acronym> and does not require a copy of Windows to run it. While a number of Windows applications will not run at all under Wine, there is the odd app or game that runs better under Wine than real Windows! In most cases though, <acronym title="Microsoft">MS</acronym> Windows apps run slower under Wine than under a genuine Windows install. Overall, it is recommended to run native GNU/Linux software instead of using Windows software under Wine, but the option of Wine allows flexibility if no suitable, Linux-native alternative software is available at the moment.
</p>

</div>

<h2><span name="what_is_wineasio" id="what_is_wineasio">What is WineASIO?</span></h2>
<div class="level2">

<p>

Audio Stream Input/Output (ASIO) is the most common low-latency sound card driver protocol for <acronym title="Microsoft">MS</acronym> Windows, hence most professional Windows audio software is designed to work with ASIO. KXStudio includes WineASIO which provides an ASIO to JACK driver for Wine. This allows ASIO-compatible Windows software running under Wine to access your JACK device/server as if it was an ASIO device.
</p>

</div>

<h2><span name="configure_wineasio" id="configure_wineasio">Configure WineASIO</span></h2>
<div class="level2">

<p>

WineASIO provides a few options that can be configured within Cadence. These options are:
</p>
<ul>
<li class="level1"><div class="li"> Number of inputs</div>
</li>
<li class="level1"><div class="li"> Number of outputs</div>
</li>
<li class="level1"><div class="li"> Connect to hardware (auto-connect to JACK hardware ports)</div>
</li>
<li class="level1"><div class="li"> Autostart server (start JACK automatically if not already running)</div>
</li>
<li class="level1"><div class="li"> Fixed buffersize (if off, the host is allowed to change the current JACK buffersize on the fly)</div>
</li>
<li class="level1"><div class="li"> Preferred buffersize (if fixed buffersize is off, WineASIO attempts to use this value on startup)</div>
</li>
</ul>

<p>

(Cadence WineASIO settings screenshot: <a href="http://kxstudio.sourceforge.net/screenshots/cadence4.png" class="urlextern" title="http://kxstudio.sourceforge.net/screenshots/cadence4.png" rel="nofollow">http://kxstudio.sourceforge.net/screenshots/cadence4.png</a>)
</p>

</div>

<h2><span name="registering_wineasio_libraries" id="registering_wineasio_libraries">Registering WineASIO libraries</span></h2>
<div class="level2">

<p>

If you ran KXStudio Welcome Setup before then you should already have the wineasio.dll library registered, otherwise or if you messed up your Wine configuration you should run:

</p>
<pre class="code">regsvr32 wineasio.dll</pre>

<p>

If you&#039;re running a 64-bit <acronym title="Operating System">OS</acronym> and you want to run 64-bit Windows software under wine, run the following too:

</p>
<pre class="code">wine64 regsvr32 wineasio.dll</pre>

<p>

You should only need to issue these commands once, if at all, and there is no harm in re-running them.
</p>

</div>

<h2><span name="what_is_reaper" id="what_is_reaper">What is REAPER?</span></h2>
<div class="level2">

<p>

KXStudio includes the <acronym title="Microsoft">MS</acronym> Windows version of REAPER (Rapid Environment for Audio Production, Engineering, and Recording). REAPER is proprietary software which runs as a fully-functional demo for trial. It is one of the most powerful and popular DAWs available for Windows and Mac OSX, and a native Linux version is in development. REAPER has proven popular under GNU/Linux due to its advanced audio production features, its not-<acronym title="Free/Libre and Open Source Software">FLOSS</acronym>-but-nonetheless-user-friendly licensing and its official support for running the Windows version under Wine.
</p>

</div>

<h2><span name="configure_reaper_for_wineasio_and_jack" id="configure_reaper_for_wineasio_and_jack">Configure REAPER for WineASIO and JACK</span></h2>
<div class="level2">
<ol>
<li class="level1"><div class="li"> Start REAPER then choose Preferences, the bottom option in the Options menu, or just push CTRL+P</div>
</li>
<li class="level1"><div class="li"> Choose Device under the Audio section from the list to the left of the Preferences window</div>
</li>
<li class="level1"><div class="li"> Choose ASIO from the Audio drop-down menu at the top of the Audio device settings options. You should then see &#039;WineASIO Driver&#039; is selected as the ASIO driver.</div>
</li>
<li class="level1"><div class="li"> Choose Audio from the list to the left of the Preferences window and untick &#039;Close audio device when stopped and application is inactive&#039;</div>
</li>
<li class="level1"><div class="li"> Apply, OK, done!</div>
</li>
</ol>

</div>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 68
- 0
Documentation:Ubuntu:Meta-Packages.php View File

@@ -0,0 +1,68 @@
<?php
$PAGE_TITLE = "KXStudio Documentation";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Ubuntu:Meta-Packages");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Ubuntu", "Meta-Packages");
include_once("includes/header.php");
?>

<p>
This section describes all the meta-packages available in the KXStudio-Team Ubuntu repositories, splitted by type.
</p>

<h5><span class="mw-headline" id="MainMetaPackages">Main Meta-Packages</span></h5>
<p>
The main meta-packages will simply install Audio, Graphic or Video applications.<br />
The Audio meta-package is also split into plugin categories, for anyone that wants more plugins, but not actually more applications.<br />
It's not like your KXStudio system will get slower with a bit more applications though...
</p>
<p>
The main meta-packages are:
</p>
<ul>
<li>kxstudio-meta-audio</li>
<li>kxstudio-meta-audio-plugins</li>
<li>kxstudio-meta-audio-plugins-ladspa</li>
<li>kxstudio-meta-audio-plugins-dssi</li>
<li>kxstudio-meta-audio-plugins-lv2</li>
<li>kxstudio-meta-audio-plugins-vamp</li>
<li>kxstudio-meta-audio-plugins-vst</li>
<li>kxstudio-meta-graphics</li>
<li>kxstudio-meta-video</li>
</ul>
<p>
Some notes:<br/>
'audio' recommends 'audio-plugins', and 'audio-plugins' depends on all it's sub-packages.<br />
With the exception of KXStudio 12.04, 'graphics' recommends 'ubuntustudio-font-meta', which will install a nice collection of fonts.<br />
On KXStudio 12.04, you have to install 'ubuntustudio-font-meta' manually if you want that font collection.
</p>

<p><br/></p>

<h5><span class="mw-headline" id="ExtraMetaPackages">Extra Meta-Packages</span></h5>
<p>
The extra meta-packages are:
</p>
<ul>
<li>kxstudio-meta-codecs <i>(12.04 only)</i></li>
<li>kxstudio-meta-non-free</li>
<li>kxstudio-meta-restricted-extras</li>
</ul>
<p>
The 'codecs' package is self-explanatory, it will install a collection of codecs for gstreamer, sox and xine.<br />
</p>
<p>
The 'non-free' will install some good but close-source software, like Renoise, energyXT, and Pianoteq.<br />
These applications come as demos, see <a href="<?php echo $ROOT; ?>/Documentation:Ubuntu:RegisterCommercial">Documentation:Ubuntu:RegisterCommercial</a> to activate them if you have a license.
</p>
<p>
The 'restricted-extras' is simply a combination of '[k|x]ubuntu-restricted-extras', and some other minor "restricted" stuff.<br />
(In this case, "restricted" means that it can't be installed in Ubuntu by default, but you're safe to do it afterwards).<br />
This package recommends 'kxstudio-meta-codecs'.
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 34
- 0
Documentation:Ubuntu:RegisterCommercial.php View File

@@ -0,0 +1,34 @@
<?php
$PAGE_TITLE = "KXStudio Documentation";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Ubuntu:RegisterCommercial");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Ubuntu", "RegisterCommercial");
include_once("includes/header.php");
?>

<p>
This section describes how to activate the non-free software available in KXStudio.
<br/><br/>
</p>

<h5><span class="mw-headline" id="LoomerPlugins">Loomer plugins</span></h5>
<p>
All Loomer plugins work the same way.<br />
Just open the respective plugin GUI you have the license for, click the "Options" button at the top and select "Enter Licence Key...".<br />
Fill in your license details and you're done&#160;;)
<br/><br/>
</p>

<h5><span class="mw-headline" id="Renoise">Renoise</span></h5>
<p>
Renoise registration is a bit unusual, but fairly easy.<br />
Once you have renoise installed in KXStudio (via repositories), go to your renoise backstage account and download the latest stable linux tarball that matches your system architecture (32bit or 64bit).<br />
Unpack it, and copy the 'renoise' binary inside into '/usr/bin/'. The next time you start renoise, it will be registered to your account.<br />
<b>Warning:</b> Do not run the install script in the tarball! If you really want to do so, please remove the 'renoise' package from your system first.
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 154
- 0
Documentation:Ubuntu:Upgrade.php View File

@@ -0,0 +1,154 @@
<?php
$PAGE_TITLE = "KXStudio Documentation";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Ubuntu:Upgrade");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Ubuntu", "Upgrade");
include_once("includes/header.php");
?>

<p>
This section describes how to upgrade from a regular Ubuntu install (or variants), to a cool and fresh KXStudio Desktop.
</p>
<p>
This method will work in all supported Ubuntu versions since Lucid (10.04, 11.10, 12.04 and 12.10).<br />
The recommended version to use right now is 12.04.
</p>
<p>
KXStudio officially supports KDE4 and partially XFCE (on 12.04/12.10, KXStudio will use UbuntuStudio desktop as base as it uses XFCE).<br/>
You can still install KXStudio if using any other Desktop Environment, but there's no meta-packages for them, and we'll not document the install process here.<br/>
Create a new topic in the forums if you want support for other DEs.
</p>

<p><br/></p>

<h5><span class="mw-headline" id="Step1">Step 1 - Enable the repositories</span></h5>
<p>
Open up the 'Software Sources' (usually in the System menu), and on the 3rd party separator, add this code:<br/>
ppa:kxstudio-team/kxstudio<br/>
Alternatively, you can run this command, which has the same effect:<br/>
<code>
sudo add-apt-repository ppa:kxstudio-team/kxstudio
</code>
</p>
<p>
Next, reload the sources (method depends on the current application), and install the package 'kxstudio-repos'. Then reload the sources again.<br />
You can do the same thing in the command-line with:<br />
<code>
sudo apt-get update<br/>
sudo apt-get install kxstudio-repos<br/>
sudo apt-get update
</code>
</p>
<p>
NOTE: If you're running 12.04, it's recommended to also install 'kxstudio-repos-kde49' which will update KDE4 to the stable 4.9.5 version.
</p>

<p><br/></p>

<h5><span class="mw-headline" id="Step2">Step 2 - Update the system</span></h5>
<p>
Once you've got the repositories set-up, it's time to upgrade the system (ie, update the software, not upgrade to a newer Ubuntu release!).
</p>
<p>
Simply use whatever tool your Desktop Environment provides (Ubuntu Software Center, Synaptic, Update Manager, KPackageKit, Muon, etc).<br />
If you want to use the command-line, or if you just got too many dependency conflicts (can happen if you enabled many PPAs before upgrading to KXStudio), the command is:<br />
<code>
sudo apt-get dist-upgrade
</code><br/>
Even though it says 'dist-upgrade', it will not update the Ubuntu version. In this case, 'dist' means something like "resolve conflicts, even if some stuff gets removed".<br />
</p>
<p>
This step will take some time. Some minor questions may appear while the upgrade takes place.
</p>

<p><br/></p>

<h5><span class="mw-headline" id="Step3">Step 3 - Install the KXStudio Desktop</span></h5>
<p>
After the upgrade, it's time to install the main KXStudio packages.<br />
Just like you did to install the 'kxstudio-repos' package, now install:
</p>
<p>
For KDE4 -&gt; 'kxstudio-desktop-kde4'<br />
For XFCE -&gt; 'kxstudio-desktop-xfce'<br />
For other systems install 'kxstudio-desktop-base' and the ubuntu related package, like 'lubuntu-desktop' for LXDE<br />
</p>

<p><br/></p>

<h5><span class="mw-headline" id="Step4">Step 4 - Install the Multimedia Software</span></h5>
<p>
This step if almost optional. Here we install the basic software for Audio, Graphics and Video.<br />
Just like before, it's time to install some new meta-packages. They are available as listed here (following a tree view of dependencies):
</p>
<ul>
<li>kxstudio-meta-all</li>
<ul>
<li>kxstudio-meta-audio</li>
<ul>
<li>kxstudio-meta-audio-plugins</li>
<ul>
<li>kxstudio-meta-audio-plugins-dssi</li>
<li>kxstudio-meta-audio-plugins-ladspa</li>
<li>kxstudio-meta-audio-plugins-lv2</li>
<li>kxstudio-meta-audio-plugins-vamp</li>
<li>kxstudio-meta-audio-plugins-vst</li>
</ul>
</ul>
<li>kxstudio-meta-graphics</li>
<li>kxstudio-meta-video</li>
</ul>
<li>kxstudio-meta-codecs</li>
<li>kxstudio-meta-restricted-extras</li>
<li>kxstudio-meta-non-free</li>
</ul>
<p>
Install the meta-packages you want just like before (ie, search for the package and click to install, or use in command-line: <code>sudo apt-get install &lt;package-name&gt;</code>)<br />
See <a href="<?php echo $ROOT; ?>/Documentation:Ubuntu:Meta-Packages">Documentation:Ubuntu:Meta-Packages</a> for a description of these meta-packages.<br />
</p>
<p>
Note - meta-all recommends restricted extras, and audio recommends audio-plugins.
</p>

<p><br/></p>

<h5><span class="mw-headline" id="Step5">Step 5 - Install a Kernel (Optional)</span></h5>
<p>
This step is optional, and mostly useful for audio production only.<br />
Installing a kernel in KXStudio couldn't be easier - just install one of these packages:
</p>
<ul>
<li>kxstudio-kernel-generic</li>
<li>kxstudio-kernel-generic-pae <i>(32bit only)</i></li>
<li>kxstudio-kernel-lowlatency</li>
<li>kxstudio-kernel-lowlatency-pae <i>(32bit only)</i></li>
<li>kxstudio-kernel-realtime <i>(10.04 or 12.04)</i></li>
<li>kxstudio-kernel-realtime-pae <i>(10.04 or 12.04, 32bit only)</i></li>
</ul>
<p>
The realtime kernels are only available for 10.04 and 12.04.<br />
Ubuntu 10.04 uses a 2.6.33 RT kernel and 12.04 uses a 3.2.0 one.
</p>

<p><br/></p>

<h5><span class="mw-headline" id="Step6">Step 6 - Reboot and update settings</span></h5>
<p>
After all this, it's time to reboot.<br />
The next time you login, you'll see the KXStudio Welcome Screen to help you update your settings (and maybe the theme too).<br />
You should also run 'cadence' and change your JACK settings to your preference.<br />
Finally, just re-login again after updating the settings.
</p>

<p><br/></p>

<h5><span class="mw-headline" id="Step7">Step 7 - Enjoy!</span></h5>
<p>
Of course, now it's time to enjoy!
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 13
- 0
Documentation:Wiki.php View File

@@ -0,0 +1,13 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "NONKXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Wiki");
$PAGE_SOURCE_2 = ARRAY("Documentation", "Wiki");
include_once("includes/header.php");
?>

<iframe id="wikitextframe" src="http://www.wiki.linuxmusicians.com/doku.php?do=export_html" scrolling="no" marginwidth="0" marginheight="0" frameborder="0" vspace="0" hspace="0"></iframe>

<?php
include_once("includes/footer.php");
?>

+ 63
- 0
Donations.php View File

@@ -0,0 +1,63 @@
<?php
$PAGE_TITLE = "KXStudio : Donations";
$PAGE_TYPE = "DONATIONS";
$PAGE_SOURCE_1 = ARRAY("/Donations");
$PAGE_SOURCE_2 = ARRAY("Donations");
include_once("includes/header.php");
?>

<p>
KXStudio is and always be a free and open-source project to everyone.<br/>
Donations will help ensure that developers have the needed enthusiasm and motivation to keep working hard on the project.<br/>
Just because we're open-source doesn't mean we're allergic to money. ;)
</p>

<p>
Currently the KXStudio project accepts donations via Flattr or PayPal.<br/>
You can do a one-time donation or subscribe monthly.<br/>
In either case, we thank you in advance for any donation you make!<br/>
<br/>
</p>

<table>
<tr><td width="40px;">
</td><td valign="bottom" width="150px">
<a class="FlattrButton" style="display:none;" href="http://kxstudio.sourceforge.net/"></a>
<noscript>
<a href="http://flattr.com/thing/1098067/KXStudio" target="_blank">
<img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" border="0" /></a>
</noscript>
</td><td valign="bottom" width="150px">
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_s-xclick">
<input type="hidden" name="hosted_button_id" value="A8QZW5UPVZGTW">
<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal">
<img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
</form>
</td><td align="center" valign="bottom" width="220px">
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_s-xclick">
<input type="hidden" name="hosted_button_id" value="7G5AKFSNVDBX8">
<table>
<tr><td>
<input type="hidden" name="on0" value="Quantity">Quantity</td></tr>
<tr><td>
<select name="os0">
<option value="Small">Small : €5.00 EUR - monthly</option>
<option value="Medium">Medium : €10.00 EUR - monthly</option>
<option value="Large">Large : €25.00 EUR - monthly</option>
</select>
</td></tr>
</table>
<input type="hidden" name="currency_code" value="EUR">
<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_subscribe_LG.gif" border="0" name="submit" alt="PayPal">
<img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
</form>
</td></tr>
</table>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 32
- 0
DownloadForced.php View File

@@ -0,0 +1,32 @@
<?php

function downloadFile($dlFile, $dlSize) {
// Must be fresh start
if (headers_sent())
die('Headers Sent');

// Required for some browsers
if (ini_get('zlib.output_compression'))
ini_set('zlib.output_compression', 'Off');

header("Pragma: public"); // required
header("Expires: 0");
header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
header("Cache-Control: private", false); // required for certain browsers
header("Content-Type: application/force-download");
header("Content-Disposition: attachment; filename=\"" . basename($dlFile) . "\";" );
header("Content-Transfer-Encoding: binary");
header("Content-Length: " . $dlSize);
ob_clean();
flush();
readfile($dlFile);
}

if (! (empty($_GET["file"]) || empty($_GET["size"]))) {
$dlFile = htmlspecialchars($_GET["file"]);
$dlSize = htmlspecialchars($_GET["size"]);

downloadFile($dlFile, $dlSize);
}

?>

+ 249
- 0
Downloads.php View File

@@ -0,0 +1,249 @@
<?php
$PAGE_TITLE = "KXStudio : Downloads";
$PAGE_TYPE = "DOWNLOADS";
$PAGE_SOURCE_1 = ARRAY("/Downloads");
$PAGE_SOURCE_2 = ARRAY("Downloads");
include_once("includes/header.php");

if (isset($_GET["id"])) {

$DOWNLOAD_IDS = ARRAY();

// KXStudio ISOs
$DOWNLOAD_IDS["101"] = "KXStudio_12.04.1_32bit.iso";
$DOWNLOAD_IDS["102"] = "KXStudio_12.04.1_64bit.iso";

// Cadence binaries
$DOWNLOAD_IDS["201"] = "Cadence-0.8-beta2-linux32.tar.xz";
$DOWNLOAD_IDS["202"] = "Cadence-0.8-beta2-linux64.tar.xz";
$DOWNLOAD_IDS["205"] = "Cadence-0.8-beta2-win32.zip";

// Carla binaries
$DOWNLOAD_IDS["211"] = "Carla-0.8-linux32.tar.xz";
$DOWNLOAD_IDS["212"] = "Carla-0.8-linux64.tar.xz";
$DOWNLOAD_IDS["215"] = "Carla-0.8-win32.zip";

// Deprecated binaries
$DOWNLOAD_IDS["301"] = "festige-1.0.2-x86.tar.gz";

$dlId = htmlspecialchars($_GET["id"]);

if (array_key_exists($dlId, $DOWNLOAD_IDS)) {

// Set sizes
$SIZE_IDS["101"] = "1745909760";
$SIZE_IDS["102"] = "1863237632";
$SIZE_IDS["201"] = "13419996";
$SIZE_IDS["202"] = "21380936";
$SIZE_IDS["205"] = "28950659";
$SIZE_IDS["211"] = "19637728";
$SIZE_IDS["212"] = "21272596";
$SIZE_IDS["215"] = "18927509";
$SIZE_IDS["301"] = "3705332";

$dlFile = $DOWNLOAD_IDS[$dlId];
$dlPath = "http://downloads.sourceforge.net/kxstudio/" . $dlFile;
$dlSize = $SIZE_IDS[$dlId];
?>

<p class="p_bigger_text">
You are now downloading the file <b><?php echo $dlFile; ?></b><br/>
If the download doesn't start automatically, click
<a href="<?php echo $dlPath; ?>" class="external free" rel="nofollow" target="_blank">here</a>.
</p>

<a href="http://www.wargsang.de/KXStudioDownload.php?file=<?php echo $dlPath; ?>&size=<?php echo $dlSize; ?>" id="downloadRefId" style="display:none"></a>

<hr>

<p>
Thank you for your interest on KXStudio and/or its software. <b>Please consider a donation</b> while the download takes place.<br/>
Donations will help ensure that developers have the needed enthusiasm and motivation to keep working hard on the project.<br/>
Just because we're open-source doesn't mean we're allergic to money. ;)
</p>

<p>
Currently the KXStudio project accepts donations via Flattr or PayPal.<br/>
You can do a one-time donation or subscribe monthly.<br/>
In either case, we thank you in advance for any donation you make!<br/>
<br/>
</p>

<table>
<tr><td width="40px;">
</td><td valign="bottom" width="150px">
<a class="FlattrButton" style="display:none;" href="http://kxstudio.sourceforge.net/"></a>
<noscript>
<a href="http://flattr.com/thing/1098067/KXStudio" target="_blank">
<img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" border="0" /></a>
</noscript>
</td><td valign="bottom" width="150px">
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_s-xclick">
<input type="hidden" name="hosted_button_id" value="A8QZW5UPVZGTW">
<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal">
<img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
</form>
</td><td align="center" valign="bottom" width="220px">
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_s-xclick">
<input type="hidden" name="hosted_button_id" value="7G5AKFSNVDBX8">
<table>
<tr><td>
<input type="hidden" name="on0" value="Quantity">Quantity</td></tr>
<tr><td>
<select name="os0">
<option value="Small">Small : €5.00 EUR - monthly</option>
<option value="Medium">Medium : €10.00 EUR - monthly</option>
<option value="Large">Large : €25.00 EUR - monthly</option>
</select>
</td></tr>
</table>
<input type="hidden" name="currency_code" value="EUR">
<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_subscribe_LG.gif" border="0" name="submit" alt="PayPal">
<img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
</form>
</td></tr>
</table>

<?php
} else { // array_key_exists
?>

<p class="error">
Invalid download Id.
</p>

<?php
} // array_key_exists
?>

<p><br/></p>

<?php
} else { // isset
?>

<ul id="Artwork" name="Artwork">
<li><b>Artwork</b></li>
<p>
The KXStudio artwork, which includes:<br/>
&nbsp;&nbsp;- KDE4 color scheme<br/>
&nbsp;&nbsp;- KDM theme<br/>
&nbsp;&nbsp;- KSplash theme<br/>
&nbsp;&nbsp;- Plymouth theme<br/>
&nbsp;&nbsp;- QtCurve config<br/>
&nbsp;&nbsp;- Gtk2/Qt3/Qt4 theme (using qtcurve engine)<br/>
&nbsp;&nbsp;- Gtk3 theme (using solidity engine, incomplete)<br/>
&nbsp;&nbsp;- Metacity theme<br/>
&nbsp;&nbsp;- XFWM4 theme<br/>
&nbsp;&nbsp;- Wallpapers<br/>
</p>
<p>
By using QtCurve, our theme can perfectly match Gtk2, Qt3, KDE3, Qt4 and KDE4 applications.<br/>
See the <a href="<?php echo $ROOT; ?>/Artwork">KXStudio Artwork</a> section for screenshots of various Desktop Environments using the KXStudio theme.<br/>
</p>
<p class="p_extra_spaced">
Downloads:<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/artwork/kxstudio-artwork_20121222.tar.bz2/download" class="external free a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_kxstudio.png" alt="" class="img_text_align"/> KXStudio Artwork</a> (version 2012-12-22)
</p>
</ul>

<p><br/></p>

<ul id="Binaries" name="Binaries">
<li><b>Binary Releases</b></li>
<p>
Software developed by the KXStudio Team, pre-compiled and ready to run.<br/>
</p>
<p class="p_extra_spaced">
Linux Downloads:<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_cadence.png" alt="" class="img_text_align"/> Cadence</a> (32bit, version 0.8.1)<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_cadence.png" alt="" class="img_text_align"/> Cadence</a> (64bit, version 0.8.1)<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/carla/Carla-1.1.0-linux32.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla</a> (32bit, version 1.1.0)<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/carla/Carla-1.1.0-linux64.tar.xz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla</a> (64bit, version 1.1.0)<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/festige/festige-1.0.2-x86.tar.gz/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_festige.png" alt="" class="img_text_align"/> FeSTige</a> (32bit, version 1.0.2)<br/>
</p>
<p class="p_extra_spaced">
Windows Downloads:<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-win32.zip/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_cadence.png" alt="" class="img_text_align"/> Cadence</a> (32bit, version 0.8.1)<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/carla/Carla-1.1.0-win32.zip/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla</a> (32bit, version 1.1.0)<br/>
</p>
</ul>

<p><br/></p>

<ul id="SourceCode" name="SourceCode">
<li><b>Source Code Releases</b></li>
<p>
Software developed by the KXStudio Team, released as source tarball so that distros other than Ubuntu (or advanced users) can pick it up.<br/>
If you're running an Ubuntu based system, please use the <a href="<?php echo $ROOT; ?>/Repositories">KXStudio Repositories</a> instead.
</p>
<p class="p_extra_spaced">
Downloads:<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/cadence/Cadence-0.8.1-src.tar.bz2/download" class="external free a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_cadence.png" alt="" class="img_text_align"/> Cadence</a> (version 0.8.1)<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/carla/Carla-1.1.0-src.tar.bz2/download" class="external free a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla</a> (version 1.1.0)<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/festige/festige-1.0.2-src.tar.gz/download" class="external free a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_festige.png" alt="" class="img_text_align"/> FeSTige</a> (version 1.0.2)<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/Releases/klaudia/klaudia-1.0.2.tar.gz/download" class="external free a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_klaudia.png" alt="" class="img_text_align"/> Klaudia</a> (version 1.0.2)<br/>
</p>
</ul>

<hr/>

<ul id="LiveDVD" name="LiveDVD">
<li><b>KXStudio 12.04.3 Live-DVD</b></li>
<p>
This is an Ubuntu 12.04.3 LTS based Live-DVD, used to test-drive KXStudio and/or install it to your HDD.<br/>
It contains a snapshot of the KXStudio features as of <b>Oct 17, 2013</b> or <b>17/10/2013</b>. It uses KDE4 as Desktop Environment.
</p>
<p class="p_extra_spaced">
Downloads:<br/>
</p>
<p>
<a href="http://sourceforge.net/projects/kxstudio/files/Live/KXStudio_12.04.3_32bit.iso/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_disc.png" alt="" class="img_text_align"/> KXStudio 12.04.3 Live-DVD <strong>- 32bit</strong></a><br/>
&nbsp;&nbsp;&nbsp;&nbsp;md5sum: 2e937f1249e6608369f9d17401b16887<br/>
&nbsp;&nbsp;&nbsp;&nbsp;size: 1.8 Gb
</p>
<p>
<a href="http://sourceforge.net/projects/kxstudio/files/Live/KXStudio_12.04.3_64bit.iso/download" class="external text a_bigger_text" rel="nofollow" target="_blank">
<img src="images/ico_disc.png" alt="" class="img_text_align"/> KXStudio 12.04.3 Live-DVD <strong>- 64bit</strong></a><br/>
&nbsp;&nbsp;&nbsp;&nbsp;md5sum: ecd0b53bfaddfdf96454c1840f05a90b<br/>
&nbsp;&nbsp;&nbsp;&nbsp;size: 1.9 Gb
</p>
<p>
<b>*Please* make sure to read the <a href="<?php echo $ROOT; ?>/Documentation:KXStudio12043:ReleaseNotes">Release Notes</a></b> before using this DVD.<br/>
You need to burn the ISO file into a DVD to make it usable, more details <a href="https://help.ubuntu.com/community/BurningIsoHowto" class="external free" rel="nofollow" target="_blank">here</a>.
</p>
</ul>

<p><br/></p>

<hr/>

<ul id="AllDownloads" name="AllDownloads">
<li><b>All Downloads</b></li>
<p>
You can access all the KXStudio downloads using the KXStudio SourceForge project page:<br/>
<a href="http://sourceforge.net/projects/kxstudio/files/" class="external free" rel="nofollow" target="_blank">http://sourceforge.net/projects/kxstudio/files/</a>
</p>
</ul>

<p><br/></p>

<?php
} // isset
include_once("includes/footer.php");
?>

+ 193
- 0
News.php View File

@@ -0,0 +1,193 @@
<?php
$PAGE_TITLE = "KXStudio News";
$PAGE_TYPE = "NORMAL";
$PAGE_SOURCE_1 = ARRAY("/News");
$PAGE_SOURCE_2 = ARRAY("News");
include_once("includes/header.php");
?>

<p><b>THIS IS A FAKE PAGE, KXSTUDIO NEWS USES A DYNAMIC MODULE NOW</b></p>

<div style="position: absolute; top: 120px; right: 100px;">
<a href="http://feeds.launchpad.net/kxstudio/announcements.atom"><img src="images/rss.png" alt="RSS"/></a>
</div>

<p>
<span style="font-size: 20px">&gt; Carla Plugin Host 1.0.0 released!</span><br/>
On <i>2013-07-02</i> by<i> falkTX</i>
</p>
<p>
After more than 2 years in development, here it is - the first stable release of Carla is now available!<br/>
<a href="http://kxstudio.sourceforge.net/screenshots/carla.png"><img src="http://kxstudio.sourceforge.net/screenshots/carla.png" alt="carla.png"/></a><br/>
</p>
<p>
Carla Plugin Host, or just Carla, is an audio plugin host, with support for many audio drivers and plugin formats.<br/>
It has some nice features like automation of parameters via MIDI CC and full OSC control.<br/>
</p>
<p>
Carla currently supports LADSPA (including LRDF), DSSI, LV2, and VST plugin formats, plus GIG, SF2 and SFZ file support.<br/>
It uses JACK as the default and preferred audio driver but also supports native drivers like ALSA, DirectSound or CoreAudio.<br/>
</p>
<p>
We currently release source code plus Windows and Linux binaries (focus goes into the Linux version).<br/>
Downloads available at the usual place, <a href="http://kxstudio.sourceforge.net/Downloads#Binaries">KXStudio Downloads</a>.<br/>
</p>
<p>
For more information about Carla check its own application page <a href="http://kxstudio.sourceforge.net/Applications:Carla">here</a>.<br/>
We'll be updating that page in the next few days, with some tutorials and workflow videos as well, so stay tuned!<br/>
</p>
<p>
You can follow the release discussion over at <a href="https://linuxmusicians.com/viewtopic.php?f=24&t=11249" class="external free" rel="nofollow">LinuxMusicians forums</a>.<br/>
If you find this application useful and/or want to help further development, please consider a <a href="http://kxstudio.sourceforge.net/Donations">donation</a>.<br/>
</p>

<a href="http://kxstudio.sourceforge.net/"></a>

<hr/>

<p>
<span style="font-size: 20px">&gt; KXStudio 12.04.1 released!</span><br/>
On <i>2013-01-05</i> by<i> falkTX</i>
</p>
<p>
After much hard work, a new release of KXStudio is ready!<br/>
The previous ISO images were getting old, and since Cadence (and KXStudio in general) is now much more stable, it was time for an update.<br/>
Existing KXStudio users already have 90% of the changes and fixes as KXStudio uses the repositories for everything.<br/>
Still, this is a big milestone for the project. It's a step towards perfection.
</p>
<p>
Here's a quick list of changes since the previous 12.04 release.
<p>
<ul>
<b>Apps:</b>
<li>Add AriaMaestosa, Giada and Petri-Foo to the DVD and default install</li>
<li>Upgrade Cadence to the beta1 release (lots of fixes!)</li>
<li>Fully up-to-date apps and plugins (as of 30/12/2012)</li>
<li>Use KDE 4.9.4 on the Live-DVD (repositories now have 4.9.5)</li>
<li>Use Firefox-KDE PPA on the Live-DVD</li>
</ul>
<ul>
<b>Desktop/Theme:</b>
<li>Add kxstudio-text plymouth (used when no gpu drivers are available)</li>
<li>Fix plymouth Live-DVD "eject disk now" text not visible (and any other labels/info)</li>
<li>Change KDE desktop theme to slim-glow (backported latest release from KDE 4.10)</li>
<li>Change cursor theme to oxy-zion</li>
<li>Disable KDE bouncing cursor by default</li>
<li>Use Claudia-Launcher instead of Klaudia in KDE kickoff (start menu)</li>
</ul>
<ul>
<b>Settings:</b>
<li>Auto-disable PulseAudio respawn</li>
<li>Set default asoundrc file to snd-aloop</li>
<li>Set default jack prio to 85</li>
<li>Use ALSA-Audio bridge instead of PulseAudio (no longer installed by default)</li>
</ul>
<ul>
<b>Welcome Wizard:</b>
<li>Add theme screenshot button</li>
<li>Add theme font size option</li>
<li>Auto-register 64bit WineAsio too (done in 'wine stuff' step)</li>
<li>Don't update user theme to KXStudio by default</li>
<li>Disable theme updates if not running KDE4 or XFCE</li>
</ul>
<p>
The DVD works properly now (no need to re-login to apply settings anymore) and also has an option to boot to RAM (requires at least 3Gb to work).<br/>
You can download the new ISOs at the KXStudio website, <a href="http://kxstudio.sourceforge.net/Downloads">http://kxstudio.sourceforge.net/Downloads</a>.
<br/><br/>
</p>
<p>
This release is dedicated to Hatsuke Miku, a [virtual] Vocaloid singer that recently has seen original artwork released under a Creative Commons license.<br/>
We believe that actions like this one (and others in 2012) indicate that the world embraces open-source culture more and more, every day.<br/>
You can find more about Miku
<a href="http://www.crypton.co.jp/mp/pages/prod/vocaloid/cv01_us.jsp" class="external free" rel="nofollow" target="_blank">here</a>,
and the its CC artwork
<a href="http://piapro.net/en_for_creators.html" class="external free" rel="nofollow" target="_blank">here</a>.
<br/><br/>
</p>
<p>
We hope you enjoy KXStudio and the updated Cadence.<br/>
Soon enough the website will have full documentation for it and other subjects, so stay tuned!
</p>

<p>
<a href="http://www.linuxmusicians.com/viewtopic.php?f=24&t=10484" class="external free" rel="nofollow" target="_blank"><b>Comments and discussion</b></a>
</p>

<hr/>

<p>
<span style="font-size: 20px">&gt; Call for Testing - Cadence pre-Beta</span><br/>
On <i>2012-09-17</i> by<i> falkTX</i>
</p>
<p>
Hello everybody!<br/>
We're almost in the Beta1 release of Cadence!<br/>
<br/>
For those of you who don't know, Cadence is what KXStudio uses to manage the entire audio ecosystem.<br/>
'Cadence' is by itself the main app of a series of tools (call it the "Cadence tools").<br/>
There's 'Catia', a simple JACK patchbay; 'Claudia' is a ladish frontend, very similar to Catia (and gladish); 'Carla' is the plugin host.<br/>
Then there's the small tools - JackMeter, JackSettings, Logs, Render and XY-Controller (their names give away their funtionality).<br/>
<br/>
Cadence and its tools are currently being documented, and pages will appear here: (incomplete)<br/>
<a href="http://kxstudio.sourceforge.net/Applications" class="external free" rel="nofollow" target="_blank">http://kxstudio.sourceforge.net/Applications</a><br/>
(There's a topic in the KXStudio forums discussing the documentation <a href="http://www.linuxmusicians.com/viewtopic.php?f=47&t=9135" class="external free" rel="nofollow" target="_blank">here</a>).<br/>
<br/>
If you're running KXStudio now, you either have updates or have recently updated Cadence and sub-packages.<br/>
I'll be pushing the latest Cadence code to the KXStudio repositories frequently in the next days while the testing happens.<br/>
ArchLinux users can use this AUR package:
<a href="https://aur.archlinux.org/packages.php?ID=50747" class="external free" rel="nofollow" target="_blank">https://aur.archlinux.org/packages.php?ID=50747</a><br/>
You can checkout what's going on in the Cadence commits page:
<a href="https://github.com/falkTX/Cadence/commits/master" class="external free" rel="nofollow" target="_blank">https://github.com/falkTX/Cadence/commits/master</a><br/>
<br/>
Not everything is fully ready right now, here's a list of things that will still be done before the Beta1 release:<br/>
- Cadence audio-bridges, currently disabled<br/>
- Carla Windows plugin-bridge support (Linux 32/64bit bridges are already in place though). Note that this will remain an experimental feature even for this release.<br/>
- Carla-Control is unfinished, the GUI will do nothing useful right now.<br/>
- Catia ALSA-MIDI support is currently disabled, but will still not be activated for this release.<br/>
<br/>
<br/>
So, what needs testing?<br/>
Pretty much everything. :D<br/>
Run the apps, click on random stuff and try to make them crash. When that happens, or if notice something weird, please report the bug.<br/>
I've done my best to make the tools as stable + crash-free as possible, but we can never be too sure about these things.<br/>
<br/>
You can report bugs directly in the official bug page at
<a href="https://github.com/falkTX/Cadence/issues" class="external free" rel="nofollow" target="_blank">https://github.com/falkTX/Cadence/issues</a>.<br/>
(Reporting a bug in that page allows you to receive notifications whenever something is done related to it).<br/>
<br/>
<br/>
Thanks in advance to everyone that decides to help!<br/>
If you love these tools and they are useful to you, please consider making donation by following this link:<br/>
<a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PDGZL8PKSNHYW" class="external free" rel="nofollow" target="_blank">https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PDGZL8PKSNHYW</a>.
</p>

<hr/>

<p>
<span style="font-size: 20px">&gt; KXStudio 12.04 is out!</span><br/>
On <i>2011-12-21</i> by<i> falkTX</i>
</p>
<p>
Hey there everyone, it's that time again!<br/>
KXStudio is now ready for the masses, now using Ubuntu 12.04 as the base.
</p><p>KDE4 remains the officially supported Desktop, with XFCE on 2nd place.<br/>
For this release I re-introduced the ISOs, although only 32bit for now. So now installing KXStudio can take 3 forms: Live-DVD, Ubuntu upgrade or NetBoot.<br />
The Live-DVD uses KDE4, if you want XFCE instead please install UbuntuStudio first then follow the upgrade instructions as detailed <a href="<?php echo $ROOT; ?>/Documentation:Ubuntu:Upgrade">here</a>.
</p><p>The Cadence tools are currently being ported to python3 in a new repo - <a href="https://github.com/falkTX/Cadence" class="external free" rel="nofollow" target="_blank">https://github.com/falkTX/Cadence</a>.<br/>
Catarina, Catia, Claudia and the minor tools are almost beta state right now. Carla and Claudia-Launcher are still in the works (but already very functional), and the real 'Cadence' app is yet to be ported.<br/>
These tools are already available on KXStudio in their latest git state, and will be released as beta for the while world very soon.
</p><p>The DISTRHO plugin suite is now near completion and it's targeted for a new release this weekend.<br/>
The entire collection is already available in the KXStudio repos but yet part of the meta-packages (will be added shortly after the official release).<br/>
Generic linux binaries will be made available for non-KXStudio users as before.
</p>

<hr/>

<p>
Note: Since the KXStudio website has been internally reworked (removed mediawiki, much simpler PHP code now), the old news have been removed.<br/>
<br/>
</p>

<?php
include_once("includes/footer.php");
?>

+ 80
- 0
Plugins.php View File

@@ -0,0 +1,80 @@
<?php
$PAGE_TITLE = "KXStudio : Plugins";
$PAGE_TYPE = "KXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Plugins");
$PAGE_SOURCE_2 = ARRAY("Plugins");
include_once("includes/header.php");
?>

<div class="box box-description">
<p>
This section lists the audio plugins made by the KXStudio Team.<br/>
You might also want to check:
</p>
<ul>
<li><a href="<?php echo $ROOT; ?>/Repositories:Plugins">Plugins in the repositories</a></li>
</ul>
<br/>
</div>

<h3><span class="mw-headline" id="DISTRHO"> <img src="images/distrho-big.png" alt="distrho-big.png" class="img_text_align"/> </span></h3>
<p>
DISTRHO provides cross-platform plugins and Linux ports, including HighLife and TAL NoiseMaker.<br/>
The official website for DISTRHO is <a href="http://distrho.sourceforge.net/" class="external free" rel="nofollow" target="_blank">http://distrho.sourceforge.net/</a>, and its respective forums are located
<a href="http://www.kvraudio.com/forum/viewforum.php?f=191" class="external text" rel="nofollow" target="_blank">here</a>.
</p>
<p>
NOTE: This is the project KXStudio uses to release original and Linux-ported audio plugins.<br/>
The split between projects allow us to make plugins non-dependent on KXStudio, but they are still made by the same team.<br/>
</p>

<hr/>

<h3><span class="mw-headline" id="Calf"> <img src="images/calf.png" alt="calf.png" class="img_text_align"/> Calf Plugins </span></h3>
<p>
This is a fork of the latest development code of the Calf plugin suite, originally available at <a href="http://repo.or.cz/w/calf.git/" class="external free" rel="nofollow" target="_blank">http://repo.or.cz/w/calf.git/</a>.<br/>
</p>
<p>
This fork was made to re-add purposefully removed features by Calf developers, which includes LADSPA, DSSI and LV2 External-UI support.<br/>
Additionally, LRDF typos were corrected and all DSSI GUIs work now.
</p>
<p>
The new source code is available <a href="https://github.com/falkTX/calf" class="external text" rel="nofollow" target="_blank">here</a>.
</p>

<hr/>

<h3><span class="mw-headline" id="dssi-vst"> dssi-vst </span></h3>
<p>
This is a fork of dssi-vst, initially based on "k_amlie"'s code updates (to make it more RT friendly), with additional fixes from falkTX which includes:
</p>
<ul>
<li>Enabled compiler optimizations where possible (ie, -O2 -ffast-math etc)</li>
<li>Implemented time-pos support, by using a dummy jack-client (only works if host uses JACK + Transport)</li>
<li>Implemented custom data/chunk, unofficial DSSI stuff (supported in Carla and a few other hosts)</li>
<li>Fixed UI re-opening after being closed</li>
<li>Update vestige header, to make more plugins load</li>
</ul>
<p>
The source code is available <a href="https://github.com/falkTX/dssi-vst" class="external text" rel="nofollow" target="_blank">here</a>.
There's a specific dssi-vst topic in the KXStudio forums <a href="http://linuxmusicians.com/viewtopic.php?f=47&t=8128" class="external text" rel="nofollow" target="_blank">here</a>.
</p>

<hr/>

<h3><span class="mw-headline" id="lv2ext"> LV2 Extensions </span></h3>
<p>
The KXStudio project has a few LV2 extensions of its own, adding missing functionality into the LV2 stack.<br/>
These are:
</p>
<ul>
<li><a href="ns/lv2ext/external-ui">External UI</a></li>
<li><a href="ns/lv2ext/programs">Programs</a></li>
<li><a href="ns/lv2ext/rtmempool">Realtime-Safe Memory Pool</a></li>
</ul>

<br/>

<?php
include_once("includes/footer.php");
?>

+ 81
- 0
Repositories.php View File

@@ -0,0 +1,81 @@
<?php
$PAGE_TITLE = "KXStudio : Repositories";
$PAGE_TYPE = "KXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Repositories");
$PAGE_SOURCE_2 = ARRAY("Repositories");
include_once("includes/header.php");
?>

<div class="box box-description">
<p>
The KXStudio repositories support all Debian versions since Wheezy and Ubuntu 12.04 or above.<br/>
They should work on all Debian-based distributions and variants, but the way to enable them will differ.<br/>
After the repositories are enabled and the system updated, we recommend you to install the "kxstudio-default-settings" package.<br/>
</p>
<p>
You might also want to check:
</p>
<ul>
<li><a href="<?php echo $ROOT; ?>/Repositories:Applications">Applications in the repositories</a></li>
<li><a href="<?php echo $ROOT; ?>/Repositories:Plugins">Plugins in the repositories</a></li>
</ul>
<p>
Below is information on how to enable the repositories.
</p>
</div>
<hr/>

<h3><span class="mw-headline" id="Debian"><img src="images/ico_debian.png" class="img_text_align" alt=""/> Debian</h3>
<p>
Debian users can enable our repositories by installing this deb file:
<a href="https://launchpad.net/~kxstudio-debian/+archive/kxstudio/+files/kxstudio-repos_7.1.0%7Ekxstudio2_all.deb" class="external free" rel="nofollow" target="_blank">kxstudio-repos.deb</a>.<br/>
If you're running Debian Wheezy, consider installing the backports repo package as well:
<a href="https://launchpad.net/~kxstudio-debian/+archive/kxstudio/+files/kxstudio-repos-backports_7.1.0%7Ekxstudio2_all.deb" class="external free" rel="nofollow" target="_blank">kxstudio-repos-backports.deb</a>.
(*<i>only</i>* for wheezy)<br/>
</p>

<hr/>

<h3><span class="mw-headline" id="Ubuntu"><img src="images/ico_ubuntu.png" class="img_text_align" alt=""/> Ubuntu</span></h3>
<p>
Ubuntu users can also install deb files for the repositories, but different files are needed for each version.<br/>
As such, we recommend you to enable the repositories using the command-line instead. Just follow these steps:<br/>
</p>
<pre class="code">
<span style="color: rgb(110, 110, 110);"># Install needed tools</span>
sudo apt-get install software-properties-common wget<br/>
<span style="color: rgb(110, 110, 110);"># Enable KXStudio repo</span>
sudo /usr/bin/add-apt-repository -y ppa:kxstudio-debian/kxstudio<br/>
<span style="color: rgb(110, 110, 110);"># Update software sources</span>
sudo apt-get update<br/>
<span style="color: rgb(110, 110, 110);"># Install kxstudio-repos</span>
sudo apt-get install kxstudio-repos<br/>
<span style="color: rgb(110, 110, 110);"># Update software sources again</span>
sudo apt-get update
</pre>

<br/>

<p>
If you're running <b>Linux Mint Olivia</b> (based on Ubuntu 12.04), we need to correct for a bug in Mint's code. Run this <b>after</b> enabling the repos:
</p>
<pre class="code">
<span style="color: rgb(110, 110, 110);"># Fix add-apt-repository olivia vs precise mixup</span>
sudo sed -i "s/olivia/precise/" /etc/apt/sources.list.d/kxstudio*.list<br/>
<span style="color: rgb(110, 110, 110);"># Update software sources yet again</span>
sudo apt-get update
</pre>

<hr/>

<h3><span class="mw-headline" id="Ubuntu"><img src="images/ico_linux.png" class="img_text_align" alt=""/> Others</span></h3>
<p>
Users on other linux distributions should enable the repositories that best match their distro.<br/>
Remember that KXStudio offers repositories only for Debian and its based systems.<br/>
</p>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 106
- 0
Repositories:Applications.php View File

@@ -0,0 +1,106 @@
<?php
$PAGE_TITLE = "KXStudio : Repositories : Applications";
$PAGE_TYPE = "KXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Repositories", "/Repositories:Applications");
$PAGE_SOURCE_2 = ARRAY("Repositories", "Applications");
include_once("includes/header.php");
?>

<div class="box box-description">
<p>
This section lists the applications available in the repositories.<br/>
Click on the yellow application name to install its respective package.<br/>
You might also want to check:
</p>
<ul>
<li><a href="<?php echo $ROOT; ?>/Repositories:Plugins">Plugins in the repositories</a></li>
</ul>
<br/>
</div>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/screenshots/cadence1.png">
<img src="screenshots/thumb/cadence.png" alt="cadence" class="img_thumb_150"/>
</a></p>
</td><td>
<p>
<b><a href="apt://cadence" style="color: rgb(230,230,100);">Cadence</a></b> (JACK Toolbox)<br/>
Cadence is a set of tools useful for audio production.<br/>
This is the main app. It performs system checks, manages JACK, calls other tools and make system tweaks.<br/>
Homepage and Documentation: <a href="http://kxstudio.sf.net/cadence" class="external text" rel="nofollow" target="_blank">http://kxstudio.sf.net/cadence</a><br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/screenshots/catia.png">
<img src="screenshots/thumb/catia.png" alt="catia" class="img_thumb_150"/>
</a></p>
</td><td>
<p>
<b><a href="apt://catia" style="color: rgb(230,230,100);">Catia</a></b> (Patchbay)<br/>
Catia is a JACK Patchbay, with some neat features like A2J bridge support and JACK Transport.<br/>
It's supposed to be as simple as possible, so it can work nicely on non-Linux platforms.<br/>
Homepage and Documentation: <a href="http://kxstudio.sf.net/catia" class="external text" rel="nofollow" target="_blank">http://kxstudio.sf.net/catia</a><br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/screenshots/claudia.png">
<img src="screenshots/thumb/claudia.png" alt="claudia" class="img_thumb_150"/>
</a></p>
</td><td>
<p>
<b><a href="apt://claudia" style="color: rgb(230,230,100);">Claudia</a></b> (Session Manager)<br/>
Claudia is a LADISH frontend; it's just like Catia, but focused at session management through LADISH.<br/>
It has a bit more features than the official LADISH GUI, with a nice preview of the main canvas in the bottom-left.<br/>
It also implements the 'Claudia-Launcher' add-application style for LADISH.<br/>
Homepage and Documentation: <a href="http://kxstudio.sf.net/claudia" class="external text" rel="nofollow" target="_blank">http://kxstudio.sf.net/claudia</a><br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/screenshots/renoise.png">
<img src="screenshots/thumb/renoise.png" alt="renoise" class="img_thumb_150"/>
</a></p>
</td><td>
<p>
<b><a href="apt://renoise" style="color: rgb(230,230,100);">Renoise</a></b> (Tracker, non-free)<br/>
Renoise is a complete, expandable Digital Audio Workstation (DAW) with a refreshing twist.<br/>
It lets you record, compose, edit, process and render production-quality audio using a tracker-based approach.<br/>
It features a wide range of built-in audio processors, alongside support for all commonly used virtual instrument and effect plug-in formats.<br/>
Homepage: <a href="http://www.renoise.com" class="external text" rel="nofollow" target="_blank">http://www.renoise.com</a><br/>
User Manual: <a href="http://tutorials.renoise.com/wiki" class="external text" rel="nofollow" target="_blank">http://tutorials.renoise.com/wiki</a><br/>
</p>
</td></tr>
</table>

<table>
<tr><td align="center">
<p><a href="<?php echo $ROOT; ?>/screenshots/sunvox.png">
<img src="screenshots/thumb/sunvox.png" alt="sunvox" class="img_thumb_150"/>
</a></p>
</td><td>
<p>
<b><a href="apt://sunvox" style="color: rgb(230,230,100);">SunVox</a></b> (Tracker, non-free)<br/>

SunVox is a small, fast and powerful modular synthesizer with pattern based sequencer (tracker).<br/>
It is a tool for those people who like to compose music wherever they are, whenever they wish.<br/>
On any device. SunVox is available for Windows, Linux, Mac OS X, Windows Mobile, PalmOS, Maemo, Meego, iOS and Android.<br/>
Homepage: <a href="http://www.warmplace.ru/soft/sunvox/" class="external text" rel="nofollow" target="_blank">http://www.warmplace.ru/soft/sunvox/</a><br/>
User Manual: <a href="http://www.warmplace.ru/wiki/sunvox:manual_en" class="external text" rel="nofollow" target="_blank">http://www.warmplace.ru/wiki/sunvox:manual_en</a><br/>
</p>
</td></tr>
</table>

<p><br/></p>

<?php
include_once("includes/footer.php");
?>

+ 39
- 0
Repositories:Plugins.php View File

@@ -0,0 +1,39 @@
<?php
$PAGE_TITLE = "KXStudio : Repositories : Plugins";
$PAGE_TYPE = "KXSTUDIO";
$PAGE_SOURCE_1 = ARRAY("/Repositories", "/Repositories:Plugins");
$PAGE_SOURCE_2 = ARRAY("Repositories", "Plugins");
include_once("includes/header.php");
?>

<div class="box box-description">
<p>
This section lists the audio plugins available in the repositories.<br/>
Click on the green plugin name to install its respective package.<br/>
You might also want to check:
</p>
<ul>
<li><a href="<?php echo $ROOT; ?>/Repositories:Applications">Applications in the repositories</a></li>
</ul>
<br/>
</div>

<p>
<b><a href="apt://caps" style="color: rgb(100,230,100);">CAPS</a></b> (LADSPA)<br/>
The C* Audio Plugin Suite (CAPS) comprises a range of classic sound effects and a few more basic audio DSP units, signal and noise generators.<br/>
The suite's aim is to provide impeccable sound quality, computational efficiency and no perceptible latency.<br/>
Homepage and Documentation: <a href="http://quitte.de/dsp/caps.html" class="external text" rel="nofollow" target="_blank">http://quitte.de/dsp/caps.html</a><br/>
</p>

<p>
<b><a href="apt://rev-plugins" style="color: rgb(100,230,100);">REV-Plugins</a></b> (LADSPA)<br/>
Reverb LADSPA plugins.<br/>
Includes a stereo reverb plugin based on the well-known greverb, and LADSPA versions of zita-rev1 in resp. stereo and first order Ambisonic mode.<br/>
Homepage: <a href="http://kokkinizita.linuxaudio.org/linuxaudio/index.html" class="external text" rel="nofollow" target="_blank">http://kokkinizita.linuxaudio.org/linuxaudio/index.html</a><br/>
</p>

<p><br /></p>

<?php
include_once("includes/footer.php");
?>

+ 66
- 0
index.php View File

@@ -0,0 +1,66 @@
<?php
$PAGE_TITLE = "KXStudio";
$PAGE_TYPE = "HOME";
$PAGE_SOURCE_1 = ARRAY();
$PAGE_SOURCE_2 = ARRAY();
include_once("includes/header.php");
?>

<p>
KXStudio is a collection of applications and plugins for professional audio production.<br/>
KXStudio provides Debian and Ubuntu compatible repositories and its own Linux Distribution currently based on Ubuntu 12.04.3 LTS.
</p>

<p>
The KXStudio project is divided into 3 main sections:
</p>

<table>
<tr><td width="130" height="130">
<p><img src="images/cadence.png" alt="cadence.png" class="img_thumb_128"/></p>
</td><td>
<p>
<b><a href="<?php echo $ROOT; ?>/Applications">Applications</a></b><br/>
We offer our own custom set of applications and utilities for Linux and Windows.<br/>
This includes a fully-featured audio plugin host, a JACK patchbay and more.<br/>
<br/>
</p>
</td></tr>

<tr><td width="130" height="130">
<p><img src="images/distrho.png" alt="distrho.png" class="img_thumb_128"/></p>
</td><td>
<p>
<b><a href="<?php echo $ROOT; ?>/Plugins">Plugins</a></b><br/>
We provide a wide range of open-source audio plugins and Linux ports.<br/>
We also provide custom patched plugins to work better and/or support more features.<br/>
</p>
</td></tr>

<tr><td width="130" height="130">
<p><img src="images/repos.png" alt="repos.png" class="img_thumb_128"/></p>
</td><td>
<p>
<b><a href="<?php echo $ROOT; ?>/Repositories">Repositories</a></b><br/>
Debian and Ubuntu compatible repositories are available.<br/>
Use them to get extra applications and updates, or to upgrade to the KXStudio distribution.<br/>
<br/>
</p>
</td></tr>
</table>

<p><br/></p>

<hr/>

<div align="center" class="div_donate">
<p>
If you want to help development, a donation, even small, is very welcome.<br/>
Check the <a href="<?php echo $ROOT; ?>/Donations">Donations</a> section to know how you can make one.
</p>
</div>
<br/>

<?php
include_once("includes/footer.php");
?>

Write Preview
Loading…
Cancel
Save