@@ -1,6 +0,0 @@ | |||
News_/ | |||
News.chyrp.old/ | |||
donate/config.php | |||
donate/insert-value.sh | |||
paste/raw/* | |||
repo/* |
@@ -1,31 +1,2 @@ | |||
Options -Indexes | |||
Redirect 301 /cadence http://kxstudio.linuxaudio.org/Applications:Cadence | |||
Redirect 301 /cadence-jackmeter http://kxstudio.linuxaudio.org/Applications:Cadence-JackMeter | |||
Redirect 301 /cadence-jacksettings http://kxstudio.linuxaudio.org/Applications:Cadence-JackSettings | |||
Redirect 301 /cadence-logs http://kxstudio.linuxaudio.org/Applications:Cadence-Logs | |||
Redirect 301 /cadence-render http://kxstudio.linuxaudio.org/Applications:Cadence-Render | |||
Redirect 301 /cadence-xycontroller http://kxstudio.linuxaudio.org/Applications:Cadence-XYController | |||
Redirect 301 /catarina http://kxstudio.linuxaudio.org/Applications:Catarina | |||
Redirect 301 /catia http://kxstudio.linuxaudio.org/Applications:Catia | |||
Redirect 301 /claudia http://kxstudio.linuxaudio.org/Applications:Claudia | |||
Redirect 301 /claudia-launcher http://kxstudio.linuxaudio.org/Applications:Claudia-Launcher | |||
Redirect 301 /carla http://kxstudio.linuxaudio.org/Applications:Carla | |||
Redirect 301 /carla-control http://kxstudio.linuxaudio.org/Applications:Carla-Control | |||
Redirect 301 /applications http://kxstudio.linuxaudio.org/Applications | |||
Redirect 301 /documentation http://kxstudio.linuxaudio.org/Documentation | |||
Redirect 301 /donations http://kxstudio.linuxaudio.org/Donations | |||
Redirect 301 /downloads http://kxstudio.linuxaudio.org/Downloads | |||
Redirect 301 /news http://kxstudio.linuxaudio.org/News | |||
Redirect 301 /plugins http://kxstudio.linuxaudio.org/Plugins | |||
Redirect 301 /repositories http://kxstudio.linuxaudio.org/Repositories | |||
RedirectMatch 301 ^/KXStudio:(.*)$ /$1 | |||
RedirectMatch 301 ^/Documentation:Ubuntu:(.*)$ /Documentation:Repository:$1 | |||
RewriteEngine On | |||
RewriteCond %{REQUEST_FILENAME} !-f | |||
RewriteCond %{REQUEST_FILENAME} !-d | |||
RewriteCond %{REQUEST_FILENAME}\.php -f | |||
RewriteRule ^(.*)$ $1.php [L,QSA] | |||
RewriteRule (.*) https://kx.studio/$1 [L,R=301] |
@@ -1,330 +0,0 @@ | |||
<?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/> | |||
All applications are open-source and completely free. | |||
</p> | |||
<p> | |||
You might also want to check: | |||
</p> | |||
<ul> | |||
<li><a href="<?php echo $ROOT; ?>/Plugins">Plugins from the KXStudio Team</a></li> | |||
<li><a href="<?php echo $ROOT; ?>/Repositories:Applications">Applications in the KXStudio 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 & 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, VST2/3 and AU plugin formats, plus 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=""/> | |||
<img src="images/ico_mac.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"); | |||
?> |
@@ -1,84 +0,0 @@ | |||
<?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 <-> 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"); | |||
?> |
@@ -1,93 +0,0 @@ | |||
<?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"); | |||
?> |
@@ -1,82 +0,0 @@ | |||
<?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&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"); | |||
?> |
@@ -1,111 +0,0 @@ | |||
<?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"); | |||
?> |
@@ -1,93 +0,0 @@ | |||
<?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: 0xB0 + <i>channel</i> - 1<br/> | |||
Control: 0x01 <i>(Modulation, as defined in "X Controls")</i><br/> | |||
Value: <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"); | |||
?> |
@@ -1,85 +0,0 @@ | |||
<?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"); | |||
?> |
@@ -1,75 +0,0 @@ | |||
<?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="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-linux32.tar.xz" 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="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-linux64.tar.xz" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
Linux 64bit</a><br/> | |||
<img src="images/ico_mac.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-macos.dmg" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
MacOS 64bit</a><br/> | |||
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-win32.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
Windows 32bit (No SSE, for old PCs)</a><br/> | |||
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-win32-nosse.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
Windows 32bit</a><br/> | |||
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-win64.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
Windows 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"> | |||
Project page</a><br/> | |||
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/archive/master.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
Source code (zip)</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"); | |||
?> |
@@ -1,119 +0,0 @@ | |||
<?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, VST2/3 and AU 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 4 types of engine processing: | |||
</p> | |||
<ul> | |||
<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>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>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> | |||
<li><b>Patchbay</b>:<br/> | |||
Modular patchbay mode, just like in JACK Multi-client and many other modular applications.<br/> | |||
Every plugin gets its own canvas group and ports allowing you to interconnect plugin audio and MIDI. | |||
</li> | |||
</ul> | |||
<!-- 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:<br/> | |||
<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> --> | |||
<!-- 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' or 'carla-git' package names).<br/> | |||
<img src="images/ico_arch.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://aur.archlinux.org/packages/carla-git/" 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-git" class="external text a_bigger_text"> | |||
Debian/Ubuntu</a> (via KXStudio repositories)<br/> | |||
</p> | |||
<p> | |||
Pre-compiled binaries are available for Linux, Mac and Windows (version 2.0-RC4).<br/> | |||
<img src="images/ico_linux.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-linux32.tar.xz" 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="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-linux64.tar.xz" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
Linux 64bit</a><br/> | |||
<img src="images/ico_mac.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-macos.dmg" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
MacOS 64bit</a><br/> | |||
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-win32.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
Windows 32bit (No SSE, for old PCs)</a><br/> | |||
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-win32-nosse.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
Windows 32bit</a><br/> | |||
<img src="images/ico_windows.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-win64.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
Windows 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"> | |||
Project page</a><br/> | |||
<img src="images/ico_github.png" alt="" class="img_text_align_spaced"/> | |||
<a href="https://github.com/falkTX/Carla/archive/master.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
Source code (zip)</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"); | |||
?> |
@@ -1,95 +0,0 @@ | |||
<?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 & 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"); | |||
?> |
@@ -1,59 +0,0 @@ | |||
<?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"); | |||
?> |
@@ -1,48 +0,0 @@ | |||
<?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"); | |||
?> |
@@ -1,57 +0,0 @@ | |||
<?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"); | |||
?> |
@@ -1,84 +0,0 @@ | |||
<?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 /> | |||
 <i>PulseAudio</i> works nicely with JACK, although it needs a bit medium/high buffer size in order to work properly.<br /> | |||
 <i>ALSA</i> has a plugin for JACK too, although it's not perfectly stable.<br /> | |||
 <i>SDL</i>-Audio applications will need either a SDL->OSS->JACK, SDL->ALSA->JACK or SDL->PulseAudio->JACK bridge, since there's no native JACK support in SDL. If you're able to get an OSS->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 ;) | |||
</p> | |||
<p><br /></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,43 +0,0 @@ | |||
<?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&t=8078" class="external text" rel="nofollow" target="_blank">here</a>. | |||
</p> | |||
<br/> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,36 +0,0 @@ | |||
<?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"); | |||
?> |
@@ -1,80 +0,0 @@ | |||
<?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 <b>Ubuntu</b> feature, please search within the | |||
<a href="http://ubuntuforums.org/" class="external text" rel="nofollow" target="_blank">Ubuntu Forums</a>.<br/> | |||
For general <b>Linux Audio</b> help, use the | |||
<a href="http://linuxmusicians.com/" class="external text" rel="nofollow" target="_blank">LinuxMusicians Forums</a> or | |||
<a href="http://lists.linuxaudio.org/listinfo/linux-audio-user/" class="external text" rel="nofollow" target="_blank">LinuxAudio Mailing List</a>.<br/> | |||
You can also use <b>IRC</b> on irc.freenode.net (or .com) server, channel <b>#kxstudio</b> or <b>#opensourcemusicians</b>.<br/> | |||
A <b>discord</b> server is also available | |||
<a href="https://discord.gg/GHuycpX" class="external text" rel="nofollow" target="_blank">here</a>, | |||
in case you prefer that over IRC.<br/> | |||
(The discord server is going away quite soon though, as we do not want to encourage usage of proprietary systems) | |||
</p> | |||
<h2>Documentation</h2> | |||
<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://wiki.linuxaudio.org/wiki/start" class="external text" rel="nofollow" target="_blank">LinuxAudio Wiki</a></li> | |||
<li><a href="https://help.ubuntu.com/community/UbuntuStudio/HowTos" class="external text" rel="nofollow" target="_blank">UbuntuStudio Community Documentation</a></li> | |||
</ul> | |||
<!-- TOPICS --> | |||
<p> | |||
<br/> | |||
Some useful topics: | |||
</p> | |||
<!-- KXSTUDIO REPOSITORIES --> | |||
<p> | |||
<b>KXStudio Repositories</b> | |||
</p> | |||
<ul> | |||
<li><a href="<?php echo $ROOT; ?>/Documentation:Repository:Meta-Packages">Available Meta-Packages</a></li> | |||
<!-- | |||
<li><a href="<?php echo $ROOT; ?>/Documentation:Repository:RegisterCommercial">Register/Activate your purchased software</a></li> | |||
<li><a href="<?php echo $ROOT; ?>/Documentation:Repository:Upgrade">Upgrade from an existing Debian/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"); | |||
?> |
@@ -1,84 +0,0 @@ | |||
<?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"); | |||
?> |
@@ -1,54 +0,0 @@ | |||
<?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"); | |||
?> |
@@ -1,113 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio12043:About"); | |||
$PAGE_SOURCE_2 = ARRAY("Documentation", "KXStudio 12.04.3", "About"); | |||
include_once("includes/header.php"); | |||
?> | |||
<p> | |||
KXStudio 12.04.3 is an ISO release based on Ubuntu 12.04.3 LTS, made on 17/10/2013.<br/> | |||
Check the Live-DVD section in the Downloads page to download it (or just click <a href="<?php echo $ROOT; ?>/Downloads#LiveDVD">here</a>). | |||
</p> | |||
<p> | |||
The Live-DVD contains a highly optimized KDE desktop (version 4.11.1), together with a low-latency kernel (version 3.8).<br/> | |||
There's a lot of audio-related applications inside, with even more available to install via the repositories. | |||
</p> | |||
<p> | |||
The live system is based upon Kubuntu code with only a few tweaks (like auto-adding the live user to audio and video groups).<br/> | |||
Due to a Kubuntu backports issue is not possible to use Ubuntu's "LTS Enablement Stack", so the regular Xorg version is used. | |||
</p> | |||
<h3><span class="mw-headline" id="Apps"> Pre-installed applications </span></h3> | |||
<p> | |||
The list of pre-installed applications in the ISO follows, not listing audio plugins. | |||
</p> | |||
<table> | |||
<tr><td> | |||
<b>Audio</b> | |||
</td><td> | |||
| |||
| |||
</td><td> | |||
<b>Other</b> | |||
</td></tr> | |||
<tr><td valign="top"> | |||
<ul> | |||
<!-- <li>amsynth</li> --> | |||
<li>Ardour3</li> | |||
<li>Audacious</li> | |||
<li>Audacity</li> | |||
<li>Bristol</li> | |||
<li>Cadence (and sub-tools)</li> | |||
<!-- <li>Calf Plugin Suite</li> --> | |||
<li>Carla</li> | |||
<!-- <li>DISTRHO Plugins and Ports</li> --> | |||
<!-- <li>DrumGizmo</li> --> | |||
<!-- <li>Drumkv1</li> --> | |||
<li>Giada</li> | |||
<li>Guitarix</li> | |||
<li>Hydrogen</li> | |||
<li>Jamin</li> | |||
<li>Laborejo</li> | |||
<li>LinuxSampler</li> | |||
<li>LisaloQt</li> | |||
<li>LMMS</li> | |||
<li>Mixxx</li> | |||
<li>MusE</li> | |||
<li>Non-Mixer</li> | |||
<li>Non-Sequencer</li> | |||
<li>Non-Session-Manager</li> | |||
<li>Non-Timeline</li> | |||
<!-- <li>OpenAV Plugins</li> --> | |||
<li>Petri-Foo</li> | |||
<li>Phasex</li> | |||
<li>Qsampler</li> | |||
<li>Qsynth</li> | |||
<li>Qtractor</li> | |||
<li>Rakarrack</li> | |||
<li>Renoise</li> | |||
<li>Rosegarden</li> | |||
<!-- <li>Samplv1</li> --> | |||
<li>SEQ24</li> | |||
<li>SooperLooper</li> | |||
<!-- <li>Synthv1</li> --> | |||
<li>Sunvox</li> | |||
<li>VMPK</li> | |||
<li>xjadeo</li> | |||
<li>ZynAddSubFX</li> | |||
</ul> | |||
</td><td valign="top"> | |||
| |||
| |||
</td><td valign="top"> | |||
<ul> | |||
<li>Blender</li> | |||
<li>Clementine</li> | |||
<li>Digikam</li> | |||
<li>Firefox</li> | |||
<li>Gimp</li> | |||
<li>gparted</li> | |||
<li>Inkscape</li> | |||
<li>KDE base (ark, dolphin, gwenview, k3b, etc)</li> | |||
<li>Kdenlive</li> | |||
<li>LibreOffice (Impress and Writer)</li> | |||
<li>Muon</li> | |||
<li>QdvdAuthor</li> | |||
<li>SMPlayer</li> | |||
<li>Synaptic</li> | |||
<li>VLC</li> | |||
<li>Wine</li> | |||
</ul> | |||
</td></tr> | |||
</table> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,43 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio12043: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/> | |||
</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/UEqO4" class="external text" rel="nofollow">here</a> for 32bit and | |||
<a href="<?php echo $ROOT; ?>/Paste/NeFVA" 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"); | |||
?> |
@@ -1,115 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio14042:About"); | |||
$PAGE_SOURCE_2 = ARRAY("Documentation", "KXStudio 14.04.2", "About"); | |||
include_once("includes/header.php"); | |||
?> | |||
<p> | |||
<span style="color:#fa3a3a;">The information on this page is incomplete or outdated.</span> | |||
</p> | |||
<p> | |||
KXStudio 14.04.2 is an ISO release based on Ubuntu 14.04.2 LTS, made on 27/07/2015.<br/> | |||
Check the Live-DVD section in the Downloads page to download it (or just click <a href="<?php echo $ROOT; ?>/Downloads#LiveDVD">here</a>). | |||
</p> | |||
<p> | |||
The Live-DVD contains a highly optimized KDE4 desktop, together with a low-latency kernel (version 3.8).<br/> | |||
There's a lot of audio-related applications inside, with even more available to install via the repositories. | |||
</p> | |||
<p> | |||
The live system is based upon Kubuntu code with only a few tweaks (like auto-adding the live user to audio and video groups). | |||
</p> | |||
<h3><span class="mw-headline" id="Apps"> Pre-installed applications </span></h3> | |||
<p> | |||
The list of pre-installed applications in the ISO follows, not listing audio plugins. | |||
</p> | |||
<table> | |||
<tr><td> | |||
<b>Audio</b> | |||
</td><td> | |||
| |||
| |||
</td><td> | |||
<b>Other</b> | |||
</td></tr> | |||
<tr><td valign="top"> | |||
<ul> | |||
<!-- <li>amsynth</li> --> | |||
<li>Ardour</li> | |||
<li>Audacious</li> | |||
<li>Audacity</li> | |||
<li>Bristol</li> | |||
<li>Cadence (and sub-tools)</li> | |||
<!-- <li>Calf Plugin Suite</li> --> | |||
<li>Carla</li> | |||
<!-- <li>DISTRHO Plugins and Ports</li> --> | |||
<!-- <li>DrumGizmo</li> --> | |||
<!-- <li>Drumkv1</li> --> | |||
<li>Giada</li> | |||
<li>Guitarix</li> | |||
<li>Hydrogen</li> | |||
<li>Jamin</li> | |||
<li>Laborejo</li> | |||
<li>LinuxSampler</li> | |||
<li>LisaloQt</li> | |||
<li>LMMS</li> | |||
<li>Mixxx</li> | |||
<li>MusE</li> | |||
<li>Non-Mixer</li> | |||
<li>Non-Sequencer</li> | |||
<li>Non-Session-Manager</li> | |||
<li>Non-Timeline</li> | |||
<!-- <li>OpenAV Plugins</li> --> | |||
<li>Petri-Foo</li> | |||
<li>Phasex</li> | |||
<li>Qsampler</li> | |||
<li>Qsynth</li> | |||
<li>Qtractor</li> | |||
<li>Rakarrack</li> | |||
<li>Renoise</li> | |||
<li>Rosegarden</li> | |||
<!-- <li>Samplv1</li> --> | |||
<li>SEQ24</li> | |||
<li>SooperLooper</li> | |||
<!-- <li>Synthv1</li> --> | |||
<li>Sunvox</li> | |||
<li>VMPK</li> | |||
<li>xjadeo</li> | |||
<li>ZynAddSubFX</li> | |||
</ul> | |||
</td><td valign="top"> | |||
| |||
| |||
</td><td valign="top"> | |||
<ul> | |||
<li>Blender</li> | |||
<li>Clementine</li> | |||
<li>Digikam</li> | |||
<li>Firefox</li> | |||
<li>Gimp</li> | |||
<li>gparted</li> | |||
<li>Inkscape</li> | |||
<li>KDE base (ark, dolphin, gwenview, k3b, etc)</li> | |||
<li>Kdenlive</li> | |||
<li>LibreOffice (Impress and Writer)</li> | |||
<li>Muon</li> | |||
<li>QdvdAuthor</li> | |||
<li>SMPlayer</li> | |||
<li>Synaptic</li> | |||
<li>VLC</li> | |||
</ul> | |||
</td></tr> | |||
</table> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,47 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio14042:ReleaseNotes"); | |||
$PAGE_SOURCE_2 = ARRAY("Documentation", "KXStudio 14.04.2", "Release Notes"); | |||
include_once("includes/header.php"); | |||
?> | |||
<p> | |||
<span style="color:#fa3a3a;">The information on this page is incomplete or outdated.</span> | |||
</p> | |||
<p> | |||
These are the release notes related to the KXStudio 14.04.2 Release, based on Ubuntu 14.04.2 LTS.<br/> | |||
</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/UEqO4" class="external text" rel="nofollow">here</a> for 32bit and | |||
<a href="<?php echo $ROOT; ?>/Paste/NeFVA" 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"); | |||
?> |
@@ -1,117 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio14045:About"); | |||
$PAGE_SOURCE_2 = ARRAY("Documentation", "KXStudio 14.04.5", "About"); | |||
include_once("includes/header.php"); | |||
?> | |||
<p> | |||
KXStudio 14.04.5 is an ISO release based on Ubuntu 14.04.5 LTS, made on 09/06/2017.<br/> | |||
Check the Live-DVD section in the Downloads page to download it (or just click <a href="<?php echo $ROOT; ?>/Downloads#LiveDVD">here</a>). | |||
</p> | |||
<p> | |||
The Live-DVD contains a highly optimized KDE4 desktop, together with a low-latency kernel (version 3.13).<br/> | |||
There's a lot of audio-related applications inside, with even more available to install via the repositories. | |||
</p> | |||
<p> | |||
The live system is based upon Kubuntu code with several tweaks | |||
(like disable file indexer and everything else that can introduce random xruns). | |||
</p> | |||
<p><br/></p> | |||
<h4><span class="mw-headline" id="CurrentNotes">Current 14.04.5 Notes</span></h4> | |||
<ul> | |||
<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 KXStudio GTK3 theme is unfinished. Applications that use GTK3 might appear slightly broken.</li> | |||
</ul> | |||
<p><br/></p> | |||
<h3><span class="mw-headline" id="Apps"> Pre-installed applications </span></h3> | |||
<p> | |||
The list of pre-installed applications in the ISO follows, not listing audio plugins. | |||
</p> | |||
<table> | |||
<tr><td> | |||
<b>Audio</b> | |||
</td><td> | |||
| |||
| |||
</td><td> | |||
<b>Other</b> | |||
</td></tr> | |||
<tr><td valign="top"> | |||
<ul> | |||
<!-- <li>amsynth</li> --> | |||
<li>Ardour</li> | |||
<li>Audacious</li> | |||
<li>Audacity</li> | |||
<li>Bristol</li> | |||
<li>Cadence (and sub-tools)</li> | |||
<!-- <li>Calf Plugin Suite</li> --> | |||
<li>Carla</li> | |||
<!-- <li>DISTRHO Plugins and Ports</li> --> | |||
<!-- <li>DrumGizmo</li> --> | |||
<!-- <li>Drumkv1</li> --> | |||
<li>Giada</li> | |||
<li>Guitarix</li> | |||
<li>Hydrogen</li> | |||
<li>Jamin</li> | |||
<li>LinuxSampler</li> | |||
<li>LMMS</li> | |||
<li>Mixxx</li> | |||
<li>MusE</li> | |||
<li>Non-Mixer</li> | |||
<li>Non-Sequencer</li> | |||
<li>Non-Session-Manager</li> | |||
<li>Non-Timeline</li> | |||
<!-- <li>OpenAV Plugins</li> --> | |||
<li>Petri-Foo</li> | |||
<li>Phasex</li> | |||
<li>Qsampler</li> | |||
<li>Qsynth</li> | |||
<li>Qtractor</li> | |||
<li>Rakarrack</li> | |||
<li>Rosegarden</li> | |||
<!-- <li>Samplv1</li> --> | |||
<li>SEQ24</li> | |||
<li>SooperLooper</li> | |||
<!-- <li>Synthv1</li> --> | |||
<li>xjadeo</li> | |||
<!-- <li>ZynAddSubFX</li> --> | |||
</ul> | |||
</td><td valign="top"> | |||
| |||
| |||
</td><td valign="top"> | |||
<ul> | |||
<li>Blender</li> | |||
<li>Clementine</li> | |||
<li>Digikam</li> | |||
<li>Firefox</li> | |||
<li>Gimp</li> | |||
<li>gparted</li> | |||
<li>Inkscape</li> | |||
<li>KDE base (ark, dolphin, gwenview, k3b, etc)</li> | |||
<li>Kdenlive</li> | |||
<li>LibreOffice (Impress and Writer)</li> | |||
<li>SMPlayer</li> | |||
<li>Synaptic</li> | |||
<li>VLC</li> | |||
</ul> | |||
</td></tr> | |||
</table> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,52 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio14045:ReleaseNotes"); | |||
$PAGE_SOURCE_2 = ARRAY("Documentation", "KXStudio 14.04.5", "Release Notes"); | |||
include_once("includes/header.php"); | |||
?> | |||
<p> | |||
These are the release notes related to the KXStudio 14.04.5 Release, based on Ubuntu 14.04.5 LTS.<br/> | |||
</p> | |||
<p><br/></p> | |||
<h4><span class="mw-headline" id="LiveDVDNotes">KXStudio 12.04.5 Live-DVD Notes</span></h4> | |||
<ul> | |||
<li>The live session user name is "kxstudio" and has no password.</li> | |||
<li>Synaptic is used for handling package management in the Live-DVD, users do not receive package update notifications.<br/> | |||
Users should open synaptic (or a similar tool) and do system updates on a regular basis.</li> | |||
<li>Neither PulseAudio or Wine are included in the Live-DVD, they need to be installed if required.<br/> | |||
Because Firefox now requires PulseAudio, it will not produce any sound by default on this Live-DVD. | |||
</li> | |||
<li>Sometimes the keyboard layout is not set-up correctly on the live session. This can be manually fixed by running: | |||
<pre>setxkbmap pt</pre> | |||
<i>(replace '</i>pt<i>' by the relevant keyboard layout/language).</i> | |||
</li> | |||
<li>Installation for (U)EFI systems will fail due to missing packages if not connected to the internet.<br/> | |||
If you need to install on such systems, make sure to connect to the internet before starting the installer. | |||
</li> | |||
<!-- | |||
<li>The list of packages installed on the Live-DVD is available | |||
<a href="<?php echo $ROOT; ?>/Paste/c6i94" class="external text" rel="nofollow">here</a> for 32bit and | |||
<a href="<?php echo $ROOT; ?>/Paste/MpWgT" class="external text" rel="nofollow">here</a> for 64bit.</li> | |||
--> | |||
</ul> | |||
<p><br/></p> | |||
<h4><span class="mw-headline" id="CurrentNotes">Current 14.04.5 Notes</span></h4> | |||
<ul> | |||
<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 KXStudio GTK3 theme is unfinished. Applications that use GTK3 might appear slightly broken.</li> | |||
</ul> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,115 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio1804:About"); | |||
$PAGE_SOURCE_2 = ARRAY("Documentation", "KXStudio 18.04", "About"); | |||
include_once("includes/header.php"); | |||
?> | |||
<p> | |||
KXStudio 14.04.5 is an ISO release based on Ubuntu 18.04 LTS, made on 19/05/2018.<br/> | |||
Check the Live-DVD section in the Downloads page to download it (or just click <a href="<?php echo $ROOT; ?>/Downloads#LiveDVD">here</a>). | |||
</p> | |||
<p> | |||
The Live-DVD contains a highly optimized KDE5 Plasma desktop, together with a low-latency kernel (version x.xx).<br/> | |||
There's a lot of audio-related applications inside, with even more available to install via the repositories. | |||
</p> | |||
<p> | |||
The live system is based upon the Neon distribution with several tweaks | |||
(like disable file indexer and everything else that can introduce random xruns). | |||
</p> | |||
<p><br/></p> | |||
<h4><span class="mw-headline" id="CurrentNotes">Current 18.04 Notes</span></h4> | |||
<ul> | |||
<li>TODO: test 18.04 and write relevant notes here</li> | |||
</ul> | |||
<p><br/></p> | |||
<h3><span class="mw-headline" id="Apps"> Pre-installed applications </span></h3> | |||
<p> | |||
The list of pre-installed applications in the ISO follows, not listing audio plugins.<br/> | |||
NOTE: This list is outdated! (was made for 14.04.5 and needs to be updated) | |||
</p> | |||
<table> | |||
<tr><td> | |||
<b>Audio</b> | |||
</td><td> | |||
| |||
| |||
</td><td> | |||
<b>Other</b> | |||
</td></tr> | |||
<tr><td valign="top"> | |||
<ul> | |||
<!-- <li>amsynth</li> --> | |||
<li>Ardour</li> | |||
<li>Audacious</li> | |||
<li>Audacity</li> | |||
<li>Bristol</li> | |||
<li>Cadence (and sub-tools)</li> | |||
<!-- <li>Calf Plugin Suite</li> --> | |||
<li>Carla</li> | |||
<!-- <li>DISTRHO Plugins and Ports</li> --> | |||
<!-- <li>DrumGizmo</li> --> | |||
<!-- <li>Drumkv1</li> --> | |||
<li>Giada</li> | |||
<li>Guitarix</li> | |||
<li>Hydrogen</li> | |||
<li>Jamin</li> | |||
<li>LinuxSampler</li> | |||
<li>LMMS</li> | |||
<li>Mixxx</li> | |||
<li>MusE</li> | |||
<li>Non-Mixer</li> | |||
<li>Non-Sequencer</li> | |||
<li>Non-Session-Manager</li> | |||
<li>Non-Timeline</li> | |||
<!-- <li>OpenAV Plugins</li> --> | |||
<li>Petri-Foo</li> | |||
<li>Phasex</li> | |||
<li>Qsampler</li> | |||
<li>Qsynth</li> | |||
<li>Qtractor</li> | |||
<li>Rakarrack</li> | |||
<li>Rosegarden</li> | |||
<!-- <li>Samplv1</li> --> | |||
<li>SEQ24</li> | |||
<li>SooperLooper</li> | |||
<!-- <li>Synthv1</li> --> | |||
<li>xjadeo</li> | |||
<!-- <li>ZynAddSubFX</li> --> | |||
</ul> | |||
</td><td valign="top"> | |||
| |||
| |||
</td><td valign="top"> | |||
<ul> | |||
<li>Blender</li> | |||
<li>Clementine</li> | |||
<li>Digikam</li> | |||
<li>Firefox</li> | |||
<li>Gimp</li> | |||
<li>gparted</li> | |||
<li>Inkscape</li> | |||
<li>KDE base (ark, dolphin, gwenview, k3b, etc)</li> | |||
<li>Kdenlive</li> | |||
<li>LibreOffice (Impress and Writer)</li> | |||
<li>SMPlayer</li> | |||
<li>Synaptic</li> | |||
<li>VLC</li> | |||
</ul> | |||
</td></tr> | |||
</table> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,44 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:KXStudio1804:ReleaseNotes"); | |||
$PAGE_SOURCE_2 = ARRAY("Documentation", "KXStudio 18.04", "Release Notes"); | |||
include_once("includes/header.php"); | |||
?> | |||
<p> | |||
These are the release notes related to the KXStudio 18.04 Release, based on Neon 18.04 LTS. (which in turn is based on Ubuntu)<br/> | |||
</p> | |||
<p><br/></p> | |||
<h4><span class="mw-headline" id="LiveDVDNotes">KXStudio 18.04 Live-DVD Notes</span></h4> | |||
<ul> | |||
<li>The live session user name is "kxstudio" and has no password.</li> | |||
<li>Wine is not included in the Live-DVD, it needs to be installed if required.<br/> | |||
A meta-package called kxstudio-meta-wine was created or it, for convenience. Just open Synaptic and install it. | |||
</li> | |||
<li>Sometimes the keyboard layout is not set-up correctly on the live session. This can be manually fixed by running: | |||
<pre>setxkbmap pt</pre> | |||
<i>(replace '</i>pt<i>' by the relevant keyboard layout/language).</i> | |||
</li> | |||
<li>Installation for (U)EFI systems will fail due to missing packages if not connected to the internet.<br/> | |||
If you need to install on such systems, make sure to connect to the internet before starting the installer. | |||
</li> | |||
<!--<li>The list of packages installed on the Live-DVD is available | |||
<a href="<?php echo $ROOT; ?>/Paste/c6i94" class="external text" rel="nofollow">here</a> for 32bit and | |||
<a href="<?php echo $ROOT; ?>/Paste/MpWgT" class="external text" rel="nofollow">here</a> for 64bit.</li>--> | |||
</ul> | |||
<p><br/></p> | |||
<h4><span class="mw-headline" id="CurrentNotes">Current 14.04.5 Notes</span></h4> | |||
<ul> | |||
<li>TODO: test 18.04 and write relevant notes here</li> | |||
</ul> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,137 +0,0 @@ | |||
<?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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym>. | |||
</p> | |||
</div> | |||
<h2><span name="kmix" id="kmix">kmix</span></h2> | |||
<div class="level2"> | |||
<p> | |||
The main <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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> | |||
<img src="http://wiki.linuxaudio.org/_media/wiki/kmix-tray.png" class="media" title="The kmix icon" alt="The kmix icon" /> | |||
</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 'Mixer' button within the mini mixer menu. | |||
</p> | |||
<p> | |||
<a href="<?php echo $ROOT; ?>/screenshots/kmix.png" class="media" title="kmixer.png"><img src="<?php echo $ROOT; ?>/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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> device on its own separate tab. In this screenshot the 'HDA Intel' 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 'Beep' 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. A common example of when you might need to use the kmix Configure Channels window is if you are using any SPDIF (optical) ports, which are referred to as IEC958 devices under GNU/Linux, as such controls are often not displayed by default. | |||
</p> | |||
<p> | |||
Whilst there is a standard defined for USB audio devices, relatively few devices fully comply with it. What this means for <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym>. | |||
</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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym>, under KXStudio. The main Cadence window has a 'JACK bridges' section which contains two <acronym title="Advanced Linux Sound Architecture">ALSA</acronym>/JACK bridges - one for <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> audio and one for MIDI. You will not hear audio produced by <acronym title="Advanced Linux Sound Architecture">ALSA</acronym>-only apps when JACK is running if the <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> audio bridge is stopped. Likewise, you will be unable to access MIDI devices if the <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> MIDI bridge isn'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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym>-only. Such apps will have their audio channeled via the same <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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>Skype</strong> If you don't require webcam or video support then it is recommended you use Mumble instead of Skype for VOIP. Although Mumble doesn't yet officially support JACK, there is a build of Mumble with JACK support available from the KXStudio repositories. However, if you need to use Skype it works fine provided the <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> audio bridge is running. | |||
</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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> issues in a terminal: | |||
</p> | |||
<pre class="code">alsamixer</pre> | |||
<p> | |||
The original <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> mixer | |||
</p> | |||
<pre class="code">cat /proc/asound/cards</pre> | |||
<p> | |||
Displays attached <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> devices | |||
</p> | |||
<pre class="code">cat ~/.asoundrc</pre> | |||
<p> | |||
Displays your <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> configuration file | |||
</p> | |||
<pre class="code">sudo alsactl store 0</pre> | |||
<p> | |||
Saves the current settings for <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> device 0 | |||
</p> | |||
</div> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,144 +0,0 @@ | |||
<?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="<?php echo $ROOT; ?>/screenshots/cadence1.png" class="media" title="cadence.png"><img src="<?php echo $ROOT; ?>/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 'performance' 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 'ondemand' 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 is included by default in 12.04.3.</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'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 and is also required to access FireWire devices. | |||
</p> | |||
<p> | |||
The user created during installation of KXStudio 12.04.3 is automatically added into the audio and video groups but newly created users will not be part of these groups. You can add a user to the audio group by running: | |||
</p> | |||
<pre class="code">sudo adduser <username> audio</pre> | |||
<p> | |||
Replace <username> with a KXStudio user name when you run that command in a terminal. You will then need to log out and back in or reboot before the user will be recognised as being in the audio group. Alternately, you can manage users and groups using the graphical kuser tool which is included with 12.04.3. | |||
</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><acronym title="Digital Signal Processing">DSP</acronym> 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 at least minimize) 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 size most decent quality audio 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 require more disk space. Even for professional purposes, 48kHz is usually fine as the default. Additionally, 48 and 96Khz allow for lower latency than using 44.1 or 88.2 due to the way it is calculated. | |||
</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 'Start' fail to start JACK, it is worth trying 'Force restart' 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'd like to start JACK or a LADISH studio at boot. KXStudio includes an app called Claudia which lets you create virtual 'LADISH' 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> | |||
Cadence's main window integrates the control of a few 'JACK bridges' -services which enable alternate Linux sound systems to run seemlessly atop JACK. | |||
</p> | |||
<p> | |||
The <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> audio bridge enables one or more <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> audio bridge also gets started automatically. | |||
</p> | |||
<p> | |||
The <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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 the PulseAudio bridge will not function until it has been installed. Most applications which use PA can use <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> or JACK instead so there is often no need for PA and its bridge. | |||
</p> | |||
</div> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,80 +0,0 @@ | |||
<?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 'live'"); | |||
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 'live' 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="<?php echo $ROOT; ?>/Downloads#LiveDVD" class="urlextern" title="Downloads#LiveDVD" rel="nofollow">http://kxstudio.linuxaudio.org/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'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'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. | |||
</p> | |||
<p> | |||
The other option is to boot from a USB drive. USB drives are faster than DVDs and can be set to save updates and work and function as a working system; but you won'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://linuxmusicians.com/viewtopic.php?f=19&t=11479" class="urlextern" title="http://linuxmusicians.com/viewtopic.php?f=19&t=11479" rel="nofollow">Easy2Boot</a>,<a href="http://unetbootin.sourceforge.net/" class="urlextern" title="http://unetbootin.sourceforge.net/" rel="nofollow">unetbootin</a> or the Ubuntu Startup Disk Creator to transfer the iso file and make it boot from your USB drive. Easy2Boot requires a little more effort to set up than unetbootin or USDC but it allows you to boot multiple ISOs from a single USB drive, which is immensely useful. | |||
</p> | |||
<p> | |||
Using Unetbootin is as simple as selecting the 'Diskimage' option, browsing to and selecting your downloaded KXStudio iso file, selecting the correct USB drive from the 'Drive' 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 Easy2Boot/unetbootin/USDC-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 F11 or 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 USB does not bring up the language selection menu directly; instead you may change language settings under 'System Settings'. | |||
</p> | |||
</div> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,169 +0,0 @@ | |||
<?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>Bitwig</strong> Proprietary commercial DAW geared towards electronic music production</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 (<acronym title="Linux Audio Developers Simple Plugin API">LADSPA</acronym>, 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'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>gxtuner</strong> Instrument tuner</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>setBfree</strong> Great sounding <acronym title="Digital Signal Processing">DSP</acronym> B3 Hammond organ emulator LV2 plugin </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>Tracktion</strong> Commercial DAW with unique interface and free Linux version</div> | |||
</li> | |||
<li class="level1"><div class="li"> <strong>Triceratops</strong> Triple oscillator LV2 synth</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"); | |||
?> |
@@ -1,162 +0,0 @@ | |||
<?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'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. | |||
</p> | |||
<p> | |||
The Boot-Repair process is documented <a href="https://help.ubuntu.com/community/UEFI#Converting_Ubuntu_into_EFI_or_Legacy_mode" class="urlextern" title="https://help.ubuntu.com/community/UEFI#Converting_Ubuntu_into_EFI_or_Legacy_mode" rel="nofollow">here.</a> If Boot-Repair doesn'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 Kubuntu 12.04.3 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 'Install KXStudio' icon on the desktop instead of clicking 'Install Ubuntu' when you are ready to run the installer, that is if you chose to 'Try KXStudio before installing' instead of choosing to run the installer directly at boot. | |||
</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. It is recommended you choose 'Force reset of all settings' if you have just completed a fresh install. 'Update basic settings' may be useful to people running KXStudio Welcome on an existing installation or /home partition who don't want to replace all of their settings. | |||
</p> | |||
<p> | |||
Using the KX Welcome 'Update Theme' is known to cause text visibility issues for certain web sites and apps such a qtractor so use this option with caution. Update theme has a screenshot option that gives you a preview of what the desktop looks like with its modifications applied. | |||
</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">Super Grub2 Disk</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="important_notes_for_ssd_users" id="important_notes_for_ssd_users">Important notes for SSD users</span></h2> | |||
<div class="level2"> | |||
<p> | |||
If you have installed KXStudio onto an SSD, you may experience frequent stalls early in the boot process at the KXStudio boot splash screen. You can fix this by running: | |||
</p> | |||
<pre class="code">kdesudo kate /etc/default/grub</pre> | |||
<p> | |||
Remove the word 'splash' from the GRUB_CMDLINE_LINUX_DEFAULT options, save the file then update and re-install GRUB using the two commands from the previous multi-boot section. | |||
</p> | |||
<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"); | |||
?> |
@@ -1,99 +0,0 @@ | |||
<?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's important configuration options are set within the Driver tab of Cadence's JACK Settings window which you can access via Configure under Cadence's main window, as shown below: | |||
</p> | |||
<p> | |||
<a href="<?php echo $ROOT; ?>/screenshots/cadence-jacksettings2.png" class="media" title="cadence-jack-settings.png"><img src="<?php echo $ROOT; ?>/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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> for your JACK driver. | |||
</p> | |||
<p> | |||
The top 3 drop-down options within Cadence's <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> driver configuration are the most important as these let you select which device(s) to use for physical audio IO. If 'Duplex Mode' is enabled then you can assign different <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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't have a mic input. In this case you could use your computers onboard <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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 'Tools' 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'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'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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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"); | |||
?> |
@@ -1,108 +0,0 @@ | |||
<?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 the Debian and Ubuntu base systems 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'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> | |||
The current KXStudio <acronym title="International Organization for Standardization">ISO</acronym> 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 need 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 target="_blank" href="http://wiki.linuxaudio.org/wiki/video_drivers" class="wikilink1" target="_parent" 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="<?php echo $ROOT; ?>/repo/" class="urlextern" title="repo/" rel="nofollow">http://kxstudio.linuxaudio.org/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'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 target="_blank" href="http://wiki.linuxaudio.org/wiki/package_management" class="wikilink1" target="_parent" 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.linuxaudio.org repositories. | |||
</p> | |||
<p> | |||
If you want to use strictly 100% Free Software, there are several options. Instead of using the KXStudio <acronym title="International Organization for Standardization">ISO</acronym>, KXStudio repositories can be added to any Debian-based system (which includes all Ubuntu-related systems) and you can leave out the separate non-free KXStudio repository. Debian itself is 100% Free (unless the user chooses to install extra non-free software). Additionally, FSF-endorsed distributions <a href="http://trisquel.info/" class="urlextern" title="http://trisquel.info/" rel="nofollow">Trisquel</a> (based on Ubuntu) and <a href="http://www.gnewsense.org/" class="urlextern" title="http://www.gnewsense.org/" rel="nofollow">gNewSense</a> (based on Debian) are also compatible with the KXStudioe repositories. Of these, only Debian is officially supported, but the others should work as well. | |||
</p> | |||
</div> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,61 +0,0 @@ | |||
<?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'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> | |||
The KXStudio distribution is based upon Ubuntu, one of the most popular variants of the GNU/Linux operating systems. Ubuntu is itself developed by a company called Canonical along with an extended global community of users and developers. An increasing number of third party software companies also offer software and support. While this manual focuses on installing KXStudio as a complete system, the KXStudio software repositories can also be added as a supplement to any Ubuntu- or Debian-based system. | |||
</p> | |||
<p> | |||
KXStudio began when a talented young Portuguese developer known online as falkTX saw the need for Ubuntu to have better management tools and software compilation for audio-related work. Over the years, falkTX's work has expanded to cover the base KXStudio project, the related suite of audio tools known as Cadence, 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="<?php echo $ROOT; ?>/Donations" class="urlextern" title="Donations" rel="nofollow">http://kxstudio.linuxaudio.org/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'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'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't presume that just because something works or doesn'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 target="_blank" href="http://wiki.linuxaudio.org/wiki/useful_links_and_getting_help" class="wikilink1" target="_parent" 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"); | |||
?> |
@@ -1,124 +0,0 @@ | |||
<?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'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 'Signal below threshold…' until we make the JACK connections | |||
</p> | |||
<p> | |||
4 - Use Catia or Claudia to connect the system capture_1 to 'jack_delay in' and connect 'jack_delay out' to the system playback_1 port | |||
</p> | |||
<p> | |||
5 - With both physical and JACK connections made, jack_iodelay should print output such as 'use X for the backend arguments -I and -O' | |||
</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'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><span name="disable_wireless_internet" id="disable_wireless_internet">Disable wireless internet</span></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'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><span name="close_unnecessary_programs" id="close_unnecessary_programs">Close unnecessary programs</span></h3> | |||
<div class="level3"> | |||
<p> | |||
In general, avoid running unnecessary, CPU-intensive programs when recording. | |||
</p> | |||
<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. The easiest way to avoid this is to close any web browsers. | |||
</p> | |||
</div> | |||
<h3><span name="avoid_realtime_resampling" id="avoid_realtime_resampling">Avoid realtime resampling</span></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 'on-the-fly' 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><span name="check_for_irq_conflicts" id="check_for_irq_conflicts">Check for IRQ conflicts</span></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 target="_blank" href="http://wiki.linuxaudio.org/wiki/system_configuration#solve_irq_conflict_by_unbinding_devices" class="wikilink1" target="_parent" title="system_configuration">see this guide to fixing IRQ conflicts.</a> | |||
</p> | |||
</div> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,61 +0,0 @@ | |||
<?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. <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> doesn't support FireWire audio devices — that requires FFADO and JACK (see below). | |||
</p> | |||
<p> | |||
<acronym title="Advanced Linux Sound Architecture">ALSA</acronym> alone is insufficient for most AV production tasks because only one application can access an <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> device at any one time. JACK and Pulseaudio were created mainly to overcome this restriction although they target different use cases. KXStudio includes an <acronym title="Advanced Linux Sound Architecture">ALSA</acronym>/JACK bridge program called “snd-aloop daemon” which enables the user to run <acronym title="Advanced Linux Sound Architecture">ALSA</acronym>-only apps alongside JACK and other JACK-native software. This bridge is turned on by default when JACK is started - see the <a target="_blank" href="http://wiki.linuxaudio.org/wiki/cadence_introduction" class="wikilink1" target="_parent" title="cadence_introduction">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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym>, 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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> to provide functions such as allowing more than one application to use an <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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 <acronym title="Advanced Linux Sound Architecture">ALSA</acronym>. 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"); | |||
?> |
@@ -1,151 +0,0 @@ | |||
<?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's (Personal Package Archives) which supplement the Ubuntu repositories. | |||
</p> | |||
<p> | |||
In KXStudio 12.04.3, the main package manager is called <strong>Muon</strong>. Muon is the easiest way to manage your software under KXStudio. KXStudio also includes the older Synaptic package manager and 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 'Check for updates'. 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 'Full Upgrade' then 'Apply Changes'. 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><span name="installing_packages_via_muon" id="installing_packages_via_muon">Installing packages via Muon</span></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 'Mark for Installation' button in the package details tab below or right-click the listing itself and choose 'Mark for installation'. | |||
</p> | |||
<p> | |||
If the chosen app requires additional packages be installed for it to function, 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 'Apply Changes' 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><span name="installing_from_a_deb_package_file" id="installing_from_a_deb_package_file">Installing from a .deb package file</span></h3> | |||
<div class="level3"> | |||
<p> | |||
There are many reasons why you should always try to install software from the repositories (or PPA's) rather than from .deb package files. Aside from saving time, using repositories ensures you are getting the correct packages for your distribution and then they 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'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's parent distro called Debian), look for the option that best matches your installed system. KXStudio is based upon kubuntu 12.04(.3) which is 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 'Install Package' 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 'Install Package' 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 'Removal' or 'Purge' 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 'Mark for Removal' which simply removes the package or 'Mark for Purge' which also removes the programs settings. After having found and selected all the packages you wish to remove click 'Apply Changes'. 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's)</span></h2> | |||
<div class="level2"> | |||
<p> | |||
The KXStudio repositories are themselves PPA's. In some cases, you may want to add new PPA's to your system. | |||
</p> | |||
<p> | |||
PPA'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's supply stable releases that aren'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 usually be listed on the projects website. For example, the latest stable release of LibreOffice isn't in the main repositories because it hasn'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'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"); | |||
?> |
@@ -1,86 +0,0 @@ | |||
<?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 protocol to save and restore JACK configurations or 'LADISH Studios'. 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'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's <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> audio bridge are running and you must connect the alsa2jack capture ports to qtractor's JACK inputs. In this guide we will create a simple LADISH studio with Claudia that will start JACK and the <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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'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't correct. See the previous 'An introduction to Cadence' and 'JACK Configuration' chapters for tips on setting up JACK. | |||
</p> | |||
<p> | |||
Claudia'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'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 'New Studio' from Claudia's studio menu. You can call the studio anything you want but I'll just use 'qtractor' 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've not already got JACK running, then now is a good time to start it. You can either start JACK from Cadence, choose 'Start Studio' from Claudia's studio menu or push F5 in Claudia. When you do this, you will notice Claudia's transport controls become available and at least two items appear on the studio canvas - the JACK 'Hardware Capture' and 'Hardware Playback' ports. These are only visible in Claudia when the JACK server is running. For the purposes of this example we also need the Cadence <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> audio bridge to be running. When you have the <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> audio bridge running you will see an extra two items (JACK clients) in Claudia'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 'Add New…' 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's input port - this indicates you have created a JACK connection between the two. Now do the same for alsa2jack's capture_2 and qtractor's Master/in_2 so that both the left and right channels will get sent from <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> to qtractor. Finally, connect qtractor'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="<?php echo $ROOT; ?>/screenshots/claudia-qtractor.png" class="media" title="claudia2.png"><img src="<?php echo $ROOT; ?>/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> | |||
To set a studio to auto-load at boot, go to the main Cadence window, check that 'Auto-start JACK or LADISH at login' is ticked, and then click on the three dots to the right of this text. Choose 'Load LADISH studio', select the just-created qtractor studio and then push OK. | |||
</p> | |||
<p> | |||
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"); | |||
?> |
@@ -1,225 +0,0 @@ | |||
<?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><span name="kxstudio" id="kxstudio">KXStudio</span></h3> | |||
<div class="level3"> | |||
<p> | |||
For more info on the KXStudio applications such as Cadence, Claudia and Catia | |||
</p> | |||
<p> | |||
<a href="<?php echo $ROOT; ?>/KXStudio:Applications" class="urlextern" title="KXStudio:Applications" rel="nofollow">http://kxstudio.linuxaudio.org/KXStudio:Applications</a> | |||
</p> | |||
</div> | |||
<h3><span name="hardware_compatibility" id="hardware_compatibility">Hardware Compatibility</span></h3> | |||
<div class="level3"> | |||
<p> | |||
To check to see if your sound device is supported by GNU/Linux, check the <acronym title="Advanced Linux Sound Architecture">ALSA</acronym> 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><span name="gnulinux_software_resources" id="gnulinux_software_resources">GNU/Linux software resources</span></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'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><span name="recommended_tutorials_and_guides" id="recommended_tutorials_and_guides">Recommended tutorials and guides</span></h3> | |||
<div class="level3"> | |||
<p> | |||
To get the most out of Linux, you need to understand how to use the terminal (aka console). Here'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 free and open 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><span name="fora_and_wikis" id="fora_and_wikis">Fora and wikis</span></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 LinuxAudio wiki contains all sorts of useful info for Linux audio users, including this manual | |||
</p> | |||
<p> | |||
<a href="http://wiki.linuxaudio.org" class="urlextern" title="http://wiki.linuxaudio.org" rel="nofollow">http://wiki.linuxaudio.org</a> | |||
</p> | |||
</div> | |||
<h3><span name="irc" id="irc">IRC</span></h3> | |||
<div class="level3"> | |||
<p> | |||
If you can'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"); | |||
?> |
@@ -1,110 +0,0 @@ | |||
<?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'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 'List PCI' hardware installed on your machine, including your video device - the make and model of which is listed as being a 'VGA compatible controller'. 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 'Additional Drivers' tool</span></h2> | |||
<div class="level2"> | |||
<p> | |||
The 'Additional Drivers' 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's safe to use the recommended version if you're unsure which version of the driver is best for you. Select a driver, then click 'Activate' 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="configure_default_laptop_screen_brightness" id="configure_default_laptop_screen_brightness">Configure default laptop screen brightness</span></h2> | |||
<div class="level2"> | |||
<p> | |||
Lower laptop screen brightness settings conserve energy and increase battery life but sometimes visibility can suffer. A fresh install of KXStudio/Ubuntu defaults to the lowest brightness settings, for my laptop display at least, and I find it uncomfortable on anything other than its highest brightness setting so I set that to be the default at boot by running the command: | |||
</p> | |||
<pre class="code">kdesudo kate /etc/rc.local</pre> | |||
<p> | |||
and adding the line | |||
</p> | |||
<pre class="code">echo 7 > /sys/class/backlight/acpi_video0/brightness</pre> | |||
<p> | |||
somewhere before the line that says 'exit 0'. This command sets the screen brightness to the max value of 7, the lowest brightness setting being 0. The file /sys/class/backlight/acpi_video0/max_brightness tells you what the max setting is. | |||
</p> | |||
<p> | |||
It's important to note that the path to the brightness setting as well as the values used may differ depending on your video hardware. laptop model and display config so you will have to check for the presence of these files and discover their correct locations before modifying rc.local. | |||
</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 so run a command like: | |||
</p> | |||
<pre class="code">kdesudo kate /usr/share/X11/xorg.conf.d/10-nvidia-brightness.conf</pre> | |||
<p> | |||
containing (copy/paste this into that .conf file) | |||
</p> | |||
<pre class="code">Section "Device" | |||
Identifier "Device0" | |||
Driver "nvidia" | |||
VendorName "NVIDIA Corporation" | |||
BoardName "GeForce 8600M" | |||
Option "RegistryDwords" "EnableBrightnessControl=1" | |||
Option "NoLogo" "true" | |||
EndSection</pre> | |||
<p> | |||
Then, after rebooting, I could hold the Fn key and use the up/down arrow keys to adjust my laptop screen brightness. I don't think the VendorName and BoardName matter too much here and this change should work for anyone using the non-free Nvidia driver on a laptop. | |||
</p> | |||
</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 <a href="http://wiki.cchtml.com/" class="urlextern" title="http://wiki.cchtml.com/" rel="nofollow">AMD Linux driver community wiki.</a> | |||
</p> | |||
</div> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,140 +0,0 @@ | |||
<?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. 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 currently for a specific task. | |||
</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 various 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> | |||
<a href="<?php echo $ROOT; ?>/screenshots/cadence3.png" class="media" title="cadence-wineasio.png"><img src="<?php echo $ROOT; ?>/screenshots/cadence3.png" class="media" alt="" /></a> | |||
</p> | |||
</div> | |||
<h2><span name="registering_wineasio_libraries" id="registering_wineasio_libraries">Registering WineASIO libraries</span></h2> | |||
<div class="level2"> | |||
<p> | |||
If you have run KXStudio Welcome Setup previously then you should already have the wineasio.dll library registered. Otherwise, for example if you have messed up or deleted your Wine configuration, you should run: | |||
</p> | |||
<pre class="code">regsvr32 wineasio.dll</pre> | |||
<p> | |||
If you'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, but 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="installing_reaper" id="installing_reaper">Installing REAPER</span></h2> | |||
<div class="level2"> | |||
<p> | |||
You can download Reaper from the official website at <a href="http://reaper.fm/download.php" class="urlextern" title="http://reaper.fm/download.php" rel="nofollow">http://reaper.fm/download.php</a> | |||
</p> | |||
<p> | |||
If you are using a 32-bit system, choose windows installer for reaper 32bits and for a 64 bits, choose windows installer for reaper 64 bits. | |||
</p> | |||
<p> | |||
You can simply install reaper by double clicking on the file you just download and follow the steps shown in the window that should opened. | |||
</p> | |||
<p> | |||
Then be really carefull to NOT CHECK rearoute (ASIO driver) installation. Installing rearoute could result in a conflict with WineASIO. | |||
</p> | |||
<p> | |||
then don't forget to register wine as mentionned in the previsous chapter : Registering WineASIO libraries. | |||
</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 'WineASIO Driver' is selected as the ASIO driver.</div> | |||
</li> | |||
<li class="level1"><div class="li"> Apply, OK, done!</div> | |||
</li> | |||
</ol> | |||
</div> | |||
<h2><span name="reaperclaudia_or_catia_issue" id="reaperclaudia_or_catia_issue">REAPER / Claudia (or catia) issue</span></h2> | |||
<div class="level2"> | |||
<p> | |||
To prevent some misconfiguration between REAPER and Cadence tools (Claudia or Catia), you have to set REAPER options. | |||
So, in REAPER, go to options > Preferences, then click on Audio (in the left list panel) and uncheck “close audio device when stopped and applicatin is active”. | |||
</p> | |||
</div> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,79 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio : Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Repository:Meta-Packages"); | |||
$PAGE_SOURCE_2 = ARRAY("Documentation", "Repository", "Meta-Packages"); | |||
include_once("includes/header.php"); | |||
?> | |||
<p> | |||
This section describes all the meta-packages available in the KXStudio repositories, splitted by type. | |||
</p> | |||
<h3><span class="mw-headline" id="MetaPackageList">Meta-Package List</span></h3> | |||
<p> | |||
In a tree-like view, the meta-packages are setup like this: | |||
</p> | |||
<ul> | |||
<li>kxstudio-meta-all<ul> | |||
<li>kxstudio-meta-audio</li> | |||
<li>kxstudio-meta-audio-plugins | |||
<table><tr><td> | |||
<ul> | |||
<li>kxstudio-meta-audio-plugins-collection</li> | |||
</ul> | |||
</td> | |||
<td> or </td> | |||
<td> | |||
<ul> | |||
<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> | |||
</ul> | |||
</td></tr></table> | |||
</li> | |||
<li>kxstudio-meta-graphics</li> | |||
<li>kxstudio-meta-video</li> | |||
</ul></li> | |||
<li>kxstudio-meta-restricted-extras</li> | |||
<li>kxstudio-meta-wine</li> | |||
</ul> | |||
<h3><span class="mw-headline" id="MetaPackageDetails">Meta-Package Details</span></h3> | |||
<p> | |||
The main meta-packages are Audio, Audio-Plugins, Graphics and Video.<br/> | |||
The Audio-Plugins meta-package is also split into plugin categories, for anyone that wants more plugins, but not actually more applications.<br/> | |||
</p> | |||
<p> | |||
The 'meta-restricted-extras' is simply a combination of '[k|x]ubuntu-restricted-extras', plus alsa-firmware and linux-firmware-nonfree.<br/> | |||
(In this case, "restricted" means that it can't be installed in Ubuntu by default, but you're safe to do it afterwards). | |||
</p> | |||
<p> | |||
The 'meta-wine' includes Wine audio stuff, useful to install if you want to use Windows plugins after installing the KXStudio ISO.<br/> | |||
This includes carla's Windows bridges, dssi-vst, festige, LMMS VST support and WineASIO. | |||
</p> | |||
<h3><span class="mw-headline" id="Notes">Notes</span></h3> | |||
<p> | |||
The 'meta-all' package recommends 'meta-restricted-extras' and 'meta-audio' recommends 'meta-audio-plugins'.<br/> | |||
Depending on your distro these might be treated as dependencies. | |||
</p> | |||
<p> | |||
Audio plugins packages that include several formats (like drumgizmo that includes LV2 and VST) or standalone applications (like calf-plugins) | |||
are not part of the specific 'meta-audio-plugins-*' packages.<br/> | |||
This is because installing those will install additional plugin formats and/or full applications.<br/> | |||
To ensure, for example, that you get all possible LV2 plugins, install 'meta-audio-plugins' and 'meta-audio-plugins-lv2'. | |||
</p> | |||
<p> | |||
The 'meta-audio-plugins-collection' package is an alternative to installing all plugins at once.<br/> | |||
If you're the kind of person that only wants to install the best plugins, consider installing this package first before installing other audio meta-packages.<br/> | |||
This way installing 'meta-audio' will not pull 'meta-audio-plugins-ladspa', 'meta-audio-plugins-dssi', etc. | |||
</p> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,34 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio : Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Repository:RegisterCommercial"); | |||
$PAGE_SOURCE_2 = ARRAY("Documentation", "Repository", "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 ;) | |||
<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"); | |||
?> |
@@ -1,151 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio : Documentation"; | |||
$PAGE_TYPE = "NONKXSTUDIO"; | |||
$PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Repository:Upgrade"); | |||
$PAGE_SOURCE_2 = ARRAY("Documentation", "Repository", "Upgrade"); | |||
include_once("includes/header.php"); | |||
?> | |||
<p> | |||
This section describes how to upgrade from a regular Ubuntu 12.04 install (or variants), to a cool and fresh KXStudio Desktop.<br /> | |||
<span style="color:#fa3a3a;">This method will work *only* in Ubuntu 12.04 based systems</span>. | |||
</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 -> 'kxstudio-desktop-kde4'<br /> | |||
For XFCE -> '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 <package-name></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"); | |||
?> |
@@ -1,13 +0,0 @@ | |||
<?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"); | |||
?> |
@@ -1,34 +0,0 @@ | |||
<?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 will be a free and open-source project to everyone.<br/> | |||
Donations help ensure that developers have the needed enthusiasm and motivation to keep working on the project.<br/> | |||
Just because we're open-source doesn't mean we're allergic to money. ;) | |||
</p> | |||
<p> | |||
<b>The KXStudio project is no longer taking donations.</b> | |||
</p> | |||
<p> | |||
In German law donations count as income and thus have to be taxed.<br/> | |||
It came to the point where it was more expensive for the project to have them rather than not.<br/> | |||
As such, donations have been taken down for now.<br/> | |||
They might come back at a later time, when the (single) KXStudio developer relocates to another country. | |||
</p> | |||
<p> | |||
Thanks for understanding. | |||
</p> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,107 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio : Donations"; | |||
$PAGE_TYPE = "DONATIONS"; | |||
$PAGE_SOURCE_1 = ARRAY("/Donations"); | |||
$PAGE_SOURCE_2 = ARRAY("Donations"); | |||
include_once("includes/header.php"); | |||
require "donate/config.php"; | |||
require "donate/connect.php"; | |||
$GLOBALS['biggest_donation_date'] = "Unknown"; | |||
$GLOBALS['biggest_donation_value'] = 0.0; | |||
$GLOBALS['total_ever'] = 0.0; | |||
function print_donation_year($year) { | |||
global $db_link; | |||
if ($db_link === FALSE) { | |||
echo '<tr><td colspan="6">DB connection failed</td></tr>'; | |||
return; | |||
} | |||
$amount = 0.0; | |||
$max_month = 0.0; | |||
$total_year = 0.0; | |||
$donation_count = 0.0; | |||
$sql_donations = mysqli_query($db_link, "SELECT * FROM donations WHERE YEAR(dt) = " . $year); | |||
if (mysqli_num_rows($sql_donations)) { | |||
while ($sql_row = mysqli_fetch_assoc($sql_donations)) { | |||
$amount = $sql_row["amount"]; | |||
$donation_count += 1.0; | |||
if ($amount > $max_month) { | |||
$max_month = $amount; | |||
if ($amount > $GLOBALS['biggest_donation_value']) { | |||
$GLOBALS['biggest_donation_date'] = date("Y-m-d", strtotime($sql_row["dt"])); | |||
$GLOBALS['biggest_donation_value'] = $amount; | |||
} | |||
} | |||
$total_year += $amount; | |||
} | |||
} | |||
$GLOBALS['total_ever'] += $total_year; | |||
echo '<tr>'; | |||
echo ' <td>' . $year . '</td>'; | |||
echo ' <td>' . $donation_count . '</td>'; | |||
echo ' <td>' . number_format($total_year, 2) . '€</td>'; | |||
if ($donation_count > 0.0) { | |||
echo ' <td>' . number_format($total_year/$donation_count, 2) . '€</td>'; | |||
} else { | |||
echo ' <td>0€</td>'; | |||
} | |||
echo ' <td>' . number_format($total_year/12.0, 2) . '€</td>'; | |||
echo ' <td>' . number_format($max_month, 2) . '€</td>'; | |||
echo '</tr>'; | |||
} | |||
?> | |||
<p> | |||
KXStudio is and always will be a free and open-source project to everyone.<br/> | |||
Donations help ensure that developers have the needed enthusiasm and motivation to keep working on the project.<br/> | |||
Just because we're open-source doesn't mean we're allergic to money. ;) | |||
</p> | |||
<p> | |||
This page contain statistics regarding donations made to the KXStudio project over time. | |||
</p> | |||
<div class="box box-description"> | |||
<table style="text-align:center;"> | |||
<tr> | |||
<td> Year </td> | |||
<td> Donation count </td> | |||
<td> Total received </td> | |||
<td> Average per donation </td> | |||
<td> Average per month </td> | |||
<td> Biggest single donation </td> | |||
</tr> | |||
<?php | |||
for ($year = strftime("%Y"); $year >= "2013"; $year -= 1) { | |||
print_donation_year($year); | |||
} | |||
?> | |||
</table> | |||
</div> | |||
<p> | |||
So far the KXStudio project has received <?php echo number_format($GLOBALS['total_ever'], 2); ?>€ in donations.<br/> | |||
The biggest donation ever made was on <?php echo $GLOBALS['biggest_donation_date']; ?>, with a value of <?php echo number_format($GLOBALS['biggest_donation_value'], 2); ?>€.<br/> | |||
Thank you very much for your generosity! | |||
</p> | |||
<p><br/></p> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,32 +0,0 @@ | |||
<?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); | |||
} | |||
?> |
@@ -1,96 +0,0 @@ | |||
<?php | |||
$PAGE_TITLE = "KXStudio : Downloads"; | |||
$PAGE_TYPE = "DOWNLOADS"; | |||
$PAGE_SOURCE_1 = ARRAY("/Downloads"); | |||
$PAGE_SOURCE_2 = ARRAY("Downloads"); | |||
include_once("includes/header.php"); | |||
?> | |||
<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"> | |||
<b>Linux Downloads:</b><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="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-linux32.tar.xz" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla2 </a> (32bit, version 2.0-RC4)<br/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-linux64.tar.xz" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla2 </a> (64bit, version 2.0-RC4)<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"> | |||
<b>MacOS Downloads:</b><br/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-macos.dmg" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla2 </a> (version 2.0-RC4 for macOS 10.8 or higher)<br/> | |||
</p> | |||
<p class="p_extra_spaced"> | |||
<b>Windows Downloads:</b><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="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-win32.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla2 </a> (32bit, version 2.0-RC4)<br/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-win32-nosse.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla2 </a> (32bit version 2.0-RC4, No-SSE build for old PCS)<br/> | |||
<a href="https://github.com/falkTX/Carla/releases/download/v1.9.14/Carla_2.0-RC4-win64.zip" class="external text a_bigger_text" rel="nofollow" target="_blank"> | |||
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla2 </a> (64bit, version 2.0-RC4)<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 a Debian or Ubuntu based system, please use the <a href="<?php echo $ROOT; ?>/Repositories">KXStudio Repositories</a> instead. | |||
</p> | |||
<p class="p_extra_spaced"> | |||
<b>Downloads:</b><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="https://github.com/falkTX/Carla/archive/v1.9.14.tar.gz" class="external free a_bigger_text" rel="nofollow" target="_blank"> | |||
<img src="images/ico_carla.png" alt="" class="img_text_align"/> Carla2 </a> (version 2.0-RC4)<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/> | |||
</p> | |||
</ul> | |||
<hr/> | |||
<ul id="Artwork" name="Artwork"> | |||
<li><b>Artwork</b></li> | |||
<p> | |||
The KXStudio artwork, which includes:<br/> | |||
- KDE4 color scheme<br/> | |||
- KDM theme<br/> | |||
- KSplash theme<br/> | |||
- Plymouth theme<br/> | |||
- QtCurve config<br/> | |||
- Gtk2/Qt3/Qt4 theme (using qtcurve engine)<br/> | |||
- Gtk3 theme (using solidity engine, incomplete)<br/> | |||
- Metacity theme<br/> | |||
- XFWM4 theme<br/> | |||
- 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"> | |||
<b>Downloads:</b><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> | |||
<?php | |||
include_once("includes/footer.php"); | |||
?> |
@@ -1,24 +0,0 @@ | |||
This is free and unencumbered software released into the public domain. | |||
Anyone is free to copy, modify, publish, use, compile, sell, or | |||
distribute this software, either in source code form or as a compiled | |||
binary, for any purpose, commercial or non-commercial, and by any | |||
means. | |||
In jurisdictions that recognize copyright laws, the author or authors | |||
of this software dedicate any and all copyright interest in the | |||
software to the public domain. We make this dedication for the benefit | |||
of the public at large and to the detriment of our heirs and | |||
successors. We intend this dedication to be an overt act of | |||
relinquishment in perpetuity of all present and future rights to this | |||
software under copyright law. | |||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, | |||
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF | |||
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. | |||
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR | |||
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, | |||
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR | |||
OTHER DEALINGS IN THE SOFTWARE. | |||
For more information, please refer to <http://unlicense.org> |
@@ -1,5 +0,0 @@ | |||
.DS_Store | |||
feathers/photo/lib/cache/* | |||
uploads/* | |||
includes/config.yaml.php | |||
includes/database.yaml.php |
@@ -1,7 +0,0 @@ | |||
<IfModule mod_rewrite.c> | |||
RewriteEngine On | |||
RewriteBase /News/ | |||
RewriteCond %{REQUEST_FILENAME} !-f | |||
RewriteCond %{REQUEST_FILENAME} !-d | |||
RewriteRule ^.+$ index.php [L] | |||
</IfModule> |
@@ -1,9 +0,0 @@ | |||
Chyrp is written and maintained by the Chyrp Team: | |||
Lead Developer: | |||
- Arian Xhezairi <arian@xhezairi.com> | |||
Project Founder: | |||
- Alex Suraci <i.am@toogeneric.com> |
@@ -1,27 +0,0 @@ | |||
Copyright (c) 2011 Chyrp Team (see AUTHORS) and individual contributors. | |||
Permission is hereby granted, free of charge, to any person | |||
obtaining a copy of this software and associated documentation | |||
files (the "Software"), to deal in the Software without | |||
restriction, including without limitation the rights to use, | |||
copy, modify, merge, publish, distribute, sublicense, and/or sell | |||
copies of the Software, and to permit persons to whom the | |||
Software is furnished to do so, subject to the following | |||
conditions: | |||
The above copyright notice and this permission notice shall be | |||
included in all copies or substantial portions of the Software. | |||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, | |||
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES | |||
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND | |||
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT | |||
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, | |||
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING | |||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR | |||
OTHER DEALINGS IN THE SOFTWARE. | |||
Except as contained in this notice, the name(s) of the above | |||
copyright holders shall not be used in advertising or otherwise | |||
to promote the sale, use or other dealings in this Software | |||
without prior written authorization. |
@@ -1,97 +0,0 @@ | |||
Chyrp is a blogging engine designed to be lightweight while retaining functionality. It is driven by PHP and MySQL (or SQLite), and has a great standard theme and robust module engine. You can personalize and modify it any way you want. | |||
All of your content is powered by a unique Feathers system that allows Chyrp to be whatever you want it to be. You can post anything and everything, or just stick to the default Text feather and run a regular blog. Chyrp destroys the fine line between a blog and a tumblelog. | |||
Requirements | |||
============ | |||
Chyrp will thrive on virtually any server setup, but we guarantee Chyrp to run on no less than: | |||
* PHP 5 >= 5.2.0 | |||
* MySQL: | |||
- MySQL 4.1+ | |||
* SQLite: | |||
- SQLite 3+ | |||
- PDO | |||
These requirements are more of guidelines, as these are the earliest versions of the services that we have tested Chyrp on. If you are successfully running Chyrp on an earlier version of these services, let us know. | |||
Installation | |||
============ | |||
Installing Chyrp is easier than you expect. You can do it in four steps: | |||
1. If using MySQL, create a MySQL database with a username and password. | |||
2. Download, unzip, and upload. | |||
3. Open your web browser and navigate to where you uploaded Chyrp. | |||
4. Follow through the installer at [index.php](). | |||
That's it! Chyrp will be up and running and ready for you to use. | |||
Upgrading | |||
========= | |||
Keeping Chyrp up to date is important to make sure that your blog is as safe and as awesome as possible. | |||
1. Download the latest version of Chyrp from [http://chyrp.net/](http://chyrp.net/). | |||
2. Copy your config files<sup>1</sup> to somewhere safe. | |||
3. Disable any Modules/Feathers that you downloaded for the release you're upgrading from. | |||
4. Overwrite your current Chyrp installation files with the new ones. | |||
5. Restore your config files<sup>1</sup> back to /includes/. | |||
6. Upgrade by navigating to [upgrade.php](), and restore any backups. | |||
7. Re-enable your Modules/Feathers. | |||
8. Run the upgrader again. It will run the Module/Feather upgrade tasks. | |||
<sup>1</sup> The config files vary depending on what you're upgrading from. Any of these in are considered "config files": | |||
* `/includes/config.yaml.php` | |||
* `/includes/database.yaml.php` | |||
* `/includes/config.yml.php` | |||
* `/includes/database.yml.php` | |||
* `/includes/config.php` | |||
* `/includes/database.php` | |||
Extensions | |||
========== | |||
Chyrp isn't complete without activating a few extensions. Extensions add functionality (ex. audio clips, video, photos) to Chyrp. You can find extensions for Chyrp made by the Chyrp community at [http://chyrp.net/extend](http://chyrp.net/extend). | |||
Installing Extensions | |||
===================== | |||
To install extensions, you have to determine what type of extension it is. It can be a *module*, a *feather*, a *theme*, or a *localization*. There's a different setup process for each type. | |||
## Feathers | |||
Feathers add new *post types* to Chyrp. Post types determine what kind of media you can display in your blog. | |||
1. Download and unzip the feather | |||
2. Upload the feather to the `feathers/` folder. | |||
3. Open your web browser and navigate to your Chyrp administration panel. | |||
4. Click on the *Extend* tab, and then the *Feathers* sub tab. | |||
5. Drag it from the Disabled pane to the Enabled pane. | |||
You can now use the feather by navigating to the Write tab and choosing the feather you uploaded. | |||
## Modules | |||
Installing modules is quick, easy, and painless with Chyrp. They add extra functionality to Chyrp. | |||
1. Download and unzip the module. | |||
2. Upload the module to the `modules/` folder. | |||
3. Open your web browser and navigate to your Chyrp administration panel. | |||
4. Click on the *Extend* tab and drag it from the Disabled pane to the Enabled pane. | |||
The module is now installed and is ready for action. Keep in mind that some modules may conflict with each other if they do similar tasks. They are marked with red lines between them on the Modules page. | |||
## Themes | |||
Chyrp makes applying themes to your blog easy. With a single click you can change the look of your blog. | |||
1. Download and unzip the theme. | |||
2. Upload the theme to the `themes/` folder. Make sure that it is contained in it's own folder. | |||
3. Open your web browser and navigate to your Chyrp administration panel. | |||
4. Click on the *Extend* tab, and then the *Themes* sub tab. | |||
5. Click on the screenshot of the theme you just uploaded to apply it to your blog. | |||
Chyrp can even show you what the theme will look like before anyone else sees it. In the Themes sub tab, click on the Preview button below the theme screenshot to see the theme. | |||
## Localization | |||
Chyrp is multilingual! If your first language isn't English, you can apply a new localization to Chyrp to make it speak your language. | |||
1. Download and unzip the localization. | |||
1. Upload the `.mo` file to the `includes/locale/` folder. You don't need anything else for the translation to work. | |||
1. Open your web browser and navigate to your Chyrp administration panel. | |||
1. Click on the *Settings* tab, and change the *Language* option to the language you just uploaded. |
@@ -1,82 +0,0 @@ | |||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" | |||
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> | |||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> | |||
<head> | |||
<meta http-equiv="Content-Type" content="$theme.type; charset=utf-8"/> | |||
<title>Chyrp: <?php echo $title; ?></title> | |||
<style type="text/css"> | |||
html, body, ul, ol, li, | |||
h1, h2, h3, h4, h5, h6, | |||
form, fieldset, a, p { | |||
margin: 0; | |||
padding: 0; | |||
border: 0; | |||
} | |||
html { | |||
font-size: 62.5%; | |||
} | |||
body { | |||
font: 1.25em/1.5em normal Verdana, Helvetica, Arial, sans-serif; | |||
color: #626262; | |||
background: #fff; | |||
padding: 1em 0 1em; | |||
overflow: auto; | |||
} | |||
code { | |||
color: #06B; | |||
font-family: Monaco, monospace; | |||
} | |||
h2 { | |||
margin-bottom: .75em; | |||
} | |||
.title { | |||
color: #aaa; | |||
font-size: 2em; | |||
font-weight: bold; | |||
margin: .25em 0 .5em; | |||
text-align: center; | |||
} | |||
.body { | |||
padding: 1em; | |||
} | |||
.body p { | |||
margin: 0 0 1em; | |||
} | |||
.body cite, | |||
.body pre { | |||
font-style: normal; | |||
display: block; | |||
padding: .25em 1em; | |||
background: #f0f0f0; | |||
margin: 0 -1em 1em; | |||
} | |||
.body ul, | |||
.body ol { | |||
margin: 0 0 1em 2em; | |||
} | |||
.body li { | |||
margin: 0; | |||
} | |||
a:link, a:visited { | |||
color: #6B0; | |||
} | |||
a:hover { | |||
text-decoration: underline; | |||
} | |||
a.big { | |||
font-size: 16px; | |||
color: #6B0; | |||
font-weight: bold; | |||
} | |||
a:hover { | |||
text-decoration: underline; | |||
} | |||
</style> | |||
</head> | |||
<body> | |||
<div class="title"><?php echo $title; ?></div> | |||
<div class="body"> | |||
<?php echo $body; ?> | |||
</div> | |||
</body> | |||
</html> |
@@ -1,27 +0,0 @@ | |||
<?php | |||
define('ADMIN', true); | |||
require_once "../includes/common.php"; | |||
# Prepare the controller. | |||
$admin = AdminController::current(); | |||
# Parse the route. | |||
$route = Route::current($admin); | |||
# Check if the user can view the site. | |||
if (!$visitor->group->can("view_site")) | |||
if ($trigger->exists("can_not_view_site")) | |||
$trigger->call("can_not_view_site"); | |||
else | |||
show_403(__("Access Denied"), __("You are not allowed to view this site.")); | |||
# Execute the appropriate Controller responder. | |||
$route->init(); | |||
if (!$route->success and !$admin->displayed) | |||
$admin->display($route->action); # Attempt to display it; it'll go through Modules and Feathers. | |||
$trigger->call("end", $route); | |||
ob_end_flush(); |
@@ -1,7 +0,0 @@ | |||
name: Default | |||
version: 2.1 | |||
url: http://chyrp.net/ | |||
description: The default theme provided with Chyrp, which all themes fallback onto. | |||
author: | |||
name: Alex Suraci | |||
url: http://toogeneric.com/ |
@@ -1,67 +0,0 @@ | |||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" | |||
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> | |||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="${ site.locale | split("_") | first }" lang="${ site.locale | split("_") | first }"> | |||
<head> | |||
<meta http-equiv="Content-type" content="$theme.type; charset=utf-8" /> | |||
<title>$site.name: {% block title %}$title{% endblock %}</title> | |||
<link rel="stylesheet" href="$theme_url/style.css" type="text/css" media="screen" title="no title" charset="utf-8" /> | |||
<script src="$site.chyrp_url/includes/lib/gz.php?file=jquery.js" type="text/javascript" charset="utf-8"></script> | |||
<script src="$site.chyrp_url/includes/lib/gz.php?file=plugins.js" type="text/javascript" charset="utf-8"></script> | |||
<script src="$site.chyrp_url/includes/admin.js.php?action=$route.action" type="text/javascript" charset="utf-8"></script> | |||
${ trigger.call("admin_head") } | |||
</head> | |||
<body> | |||
<div id="header"> | |||
<div class="column"> | |||
<ul id="navigation"> | |||
{% block navigation %} | |||
{% for action, nav in navigation | items %} | |||
{% if nav.show %} | |||
<li class="$action{% if nav.selected %} selected{% endif %}"$nav.attributes><a href="{% admin action %}">$nav.title</a></li> | |||
{% endif %} | |||
{% endfor %} | |||
{% endblock %} | |||
</ul> | |||
<h1><a href="$site.url">$site.name</a></h1> | |||
</div> | |||
</div> | |||
<div id="welcome"> | |||
<div class="column"> | |||
<a href="{% url "/?action=logout" %}" class="right">${ "Log Out ›" | translate }</a> | |||
${ "Hello, %s!" | translate | format(visitor.full_name | split | first | fallback(visitor.login | fallback("Guest" | translate))) } | |||
<a href="$site.url">${ "View Site ›" | translate }</a> | |||
</div> | |||
</div> | |||
<ul class="column ${ route.action }_nav" id="sub-nav"> | |||
{% block subnav %} | |||
{% if subnav[route.action] %} | |||
{% for action, nav in subnav[route.action] | items %} | |||
{% if nav.show %} | |||
<li${ route.action | selected(nav.selected, action) }$nav.attributes><a href="{% admin action %}">$nav.title</a></li> | |||
{% endif %} | |||
{% endfor %} | |||
{% endif %} | |||
{% endblock %} | |||
</ul> | |||
<div class="clear"></div> | |||
<div class="column" id="content"> | |||
{% for notice in flash.notices %} | |||
<p class="message yay">$notice</p> | |||
{% endfor %} | |||
{% for warning in flash.warnings %} | |||
<p class="message boo">$warning</p> | |||
{% endfor %} | |||
{% for message in flash.messages %} | |||
<p class="message">$message</p> | |||
{% endfor %} | |||
{% block content %}{% endblock %} | |||
<div class="clear"></div> | |||
</div> | |||
<div class="column" id="footer"> | |||
${ "Chyrp loves you." | translate }<br /> | |||
<span class="sub"> | |||
${ "v%s ‐ © %d Chyrp Team" | translate | format(version, 2011) } | |||
</span> | |||
</div> | |||
</body> | |||
</html> |
@@ -1,287 +0,0 @@ | |||
{% if not done %} | |||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" | |||
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> | |||
<html xmlns="http://www.w3.org/1999/xhtml"> | |||
<head> | |||
<meta http-equiv="Content-Type" content="$theme.type; charset=utf-8" /> | |||
<title>${ "Chyrp!" | translate }</title> | |||
<style type="text/css"> | |||
<!--/*--><![CDATA[/*><!--*/ | |||
/* Reset */ | |||
body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,code,form,fieldset,legend,input,textarea,p,blockquote,th,td { margin: 0; padding: 0; } | |||
table { border-collapse: collapse; border-spacing: 0; } | |||
fieldset,img { border: 0; } | |||
address,caption,cite,code,dfn,em,strong,th,var { font-style: normal; font-weight: normal; } | |||
li { list-style: none; } | |||
caption,th { text-align: left; } | |||
h1,h2,h3,h4,h5,h6 { font-size: 100%; font-weight: normal; } | |||
abbr,acronym { border: 0; font-variant: normal; } | |||
input, textarea, select { font-family: inherit; font-size: inherit; font-weight: inherit; } | |||
/* End Reset */ | |||
html { | |||
font-size: 62.5%; | |||
} | |||
body { | |||
font: 1.25em/1.5em normal Verdana, Helvetica, Arial, sans-serif; | |||
color: #626262; | |||
background: #e8e8e8; | |||
margin: 0; | |||
padding: 1.25em; | |||
overflow-y: auto; | |||
overflow-x: hidden; | |||
} | |||
a:link, a:visited { | |||
text-decoration: none; | |||
color: #222; | |||
border-bottom: 1px solid #ddd; | |||
} | |||
a:hover { | |||
color: #555; | |||
border-bottom-color: #aaa; | |||
} | |||
label { | |||
display: block; | |||
font-weight: bold; | |||
} | |||
p { | |||
margin: 0 0 1em; | |||
} | |||
input.text, textarea { | |||
font-size: 1.25em; | |||
padding: 3px; | |||
border: 1px solid #ddd; | |||
background: #fff; | |||
} | |||
input.code, code { | |||
font-family: "Consolas", "Monaco", monospace; | |||
} | |||
.navigation { | |||
_border: 1px solid #e8e8e8; | |||
} | |||
.navigation li a { | |||
float: left; | |||
padding: .4em .75em; | |||
background: #dfdfdf; | |||
border-top: .2em solid #e8e8e8; | |||
border-bottom: 0 !important; | |||
color: #737373; | |||
} | |||
.navigation li.selected a { | |||
background: #fff; | |||
border-top-color: #c7c7c7; | |||
} | |||
.navigation li.right { | |||
margin: .75em 0 0; | |||
} | |||
.navigation li.right a { | |||
float: none; | |||
background: transparent; | |||
padding: 0; | |||
font-size: .95em; | |||
color: #777; | |||
} | |||
.navigation li.right a { | |||
color: #444; | |||
} | |||
.content { | |||
background: #fff; | |||
padding: 1em; | |||
position: absolute; | |||
z-index: 100; | |||
{% if site.enabled_feathers | length == 1 %} | |||
position: absolute; | |||
border: 0; | |||
top: 1em; | |||
left: 1em; | |||
bottom: 1em; | |||
right: 1em; | |||
height: auto; | |||
{% endif %} | |||
} | |||
.clear { | |||
clear: both; | |||
} | |||
.wide { | |||
width: 100%; | |||
} | |||
textarea.wide, input.text.wide { | |||
width: 98%; /* Compensating for the 6px added from the padding */ | |||
_width: 100%; | |||
} | |||
.sub { | |||
display: none; | |||
} | |||
.buttons { | |||
text-align: center; | |||
} | |||
button { | |||
background: #eee; | |||
padding: .75em 1.5em; | |||
color: #777; | |||
text-shadow: #fff .1em .1em 0; | |||
font: 1em normal "Lucida Grande", Verdana, Helvetica, Arial, sans-serif; | |||
text-decoration: none; | |||
border: 0; | |||
cursor: pointer; | |||
-webkit-border-radius: .5em; | |||
-moz-border-radius: .5em; | |||
} | |||
button:hover { | |||
background: #f5f5f5; | |||
} | |||
button:active { | |||
background: #e0e0e0; | |||
} | |||
/*]]>*/--> | |||
</style> | |||
<script src="$site.chyrp_url/includes/lib/gz.php?file=jquery.js" type="text/javascript" charset="utf-8"></script> | |||
<script src="$site.chyrp_url/includes/lib/gz.php?file=plugins.js" type="text/javascript" charset="utf-8"></script> | |||
<script type="text/javascript"> | |||
<!--//--><![CDATA[//><!-- | |||
function activate_nav_tab(id) { | |||
$$("[class^='nav_']").removeClass("selected") | |||
$$("[id$$='_form']").hide() | |||
$$("#"+id+"_form").show() | |||
$$(".nav_" + id).addClass("selected") | |||
$$("#"+id+"_form input.text").expand() | |||
} | |||
$$(function(){ | |||
$$("form:visible input.text").expand() | |||
$$(".navigation li").css("float", "left") | |||
$$(".navigation").sortable({ | |||
axis: "x", | |||
containment: ".navigation", | |||
placeholder: "feathers_sort", | |||
opacity: 0.8, | |||
delay: 1, | |||
revert: true, | |||
update: function(){ | |||
$$.post("$site.chyrp_url/includes/ajax.php", "action=reorder_feathers&"+$$(".navigation").sortable("serialize")) | |||
} | |||
}) | |||
}) | |||
//--><!]]> | |||
</script> | |||
</head> | |||
<body> | |||
{% if site.enabled_feathers | length > 1 %} | |||
<ul class="navigation"> | |||
{% for feather in feathers %} | |||
<li id="list_feathers[$feather.safename]" class="nav_$feather.safename${ feather.safename | selected(selected_feather.safename, true) }"> | |||
<a href="javascript:activate_nav_tab('$feather.safename')">$feather.name</a> | |||
</li> | |||
{% endfor %} | |||
</ul> | |||
<div class="clear"></div> | |||
{% endif %} | |||
<div class="content"> | |||
{% for feather in feathers %} | |||
<form action="$site.chyrp_url/admin/?action=add_post" id="${ feather.safename }_form"{% if feather.safename != selected_feather.safename %} style="display: none"{% endif %} method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
${ trigger.call("before_bookmarklet_fields", feather) } | |||
{% for field in feather.fields %} | |||
<p> | |||
<label for="$field.attr"> | |||
$field.label | |||
{% if field.optional %} | |||
<span class="sub">${ "(optional)" | translate }</span> | |||
{% endif %} | |||
{% if field.help %} | |||
<span class="sub"> | |||
<a href="{% admin "help&id="~field.help %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
</span> | |||
{% endif %} | |||
</label> | |||
{% if field.type == "text" or field.type == "file" %} | |||
<input class="$field.type{% if field.classes %} ${ field.classes | join(" ") }{% endif %}" type="$field.type" name="$field.attr" value="{% if not field.no_value %}${ field.value | fallback(args[field.bookmarklet] | escape) }{% endif %}" id="$field.attr" /> | |||
{% elseif field.type == "text_block" %} | |||
<textarea class="wide{% if field.classes %} ${ field.classes | join(" ") }{% endif %}" rows="${ field.rows | fallback(10) }" name="$field.attr" id="$field.attr" cols="50">{% if not field.no_value %}${ field.value | fallback(args[field.bookmarklet] | escape) }{% endif %}</textarea> | |||
{% elseif field.type == "select" %} | |||
<select name="$field.attr" id="$field.attr"{% if field.classes %} class="${ field.classes | join(" ") }"{% endif %}> | |||
{% for value, name in field.options | items %} | |||
<option value="${ value | escape }"{% if not field.no_value %}${ value | option_selected(field.value | fallback(args[field.bookmarklet] | escape)) }{% endif %}>${ name | escape }</option> | |||
{% endfor %} | |||
</select> | |||
{% endif %} | |||
</p> | |||
{% endfor %} | |||
${ trigger.call("after_post_fields", feather) } | |||
<div class="buttons"> | |||
<button type="submit"> | |||
${ "Publish" | translate } | |||
</button> | |||
<input type="hidden" name="feather" value="$feather.safename" id="feather" /> | |||
<input type="hidden" name="slug" value="" id="slug" /> | |||
<input type="hidden" name="bookmarklet" value="true" id="bookmarklet" /> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</div> | |||
${ trigger.call("bookmarklet_fields") } | |||
</fieldset> | |||
</form> | |||
{% endfor %} | |||
</div> | |||
</body> | |||
</html> | |||
{% else %} {# This one is 100% credited to Tumblr. They did it perfectly, didn't want to muck it up. #} | |||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" | |||
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> | |||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> | |||
<head> | |||
<meta http-equiv="Content-Type" content="$theme.type; charset=utf-8"/> | |||
<title>${ "Chyrp!" | translate }</title> | |||
<style type="text/css"> | |||
<!--/*--><![CDATA[/*><!--*/ | |||
body { | |||
background-color: #e1e1e1; | |||
margin: 0px; | |||
font: 15px normal 'Trebuchet MS',Verdana,Helvetica,sans-serif; | |||
text-align: center; | |||
} | |||
div#content { | |||
margin: 137px 30px 0px 30px; | |||
padding: 15px; | |||
} | |||
/*]]>*/--> | |||
</style> | |||
<script type="text/javascript"> | |||
<!--//--><![CDATA[//><!-- | |||
function countdown_func() { | |||
countdown-- | |||
el = document.getElementById('countdown') | |||
if (countdown == 1) | |||
el.firstChild.nodeValue = "${ "or wait 1 seconds." | translate }" | |||
else if (countdown > 0) | |||
el.firstChild.nodeValue = "${ "or wait 2 seconds." | translate }" | |||
else | |||
self.close() | |||
if (countdown > 0) | |||
setTimeout('countdown_func()', 1000) | |||
} | |||
var countdown = 3; | |||
//--><!]]> | |||
</script> | |||
</head> | |||
<body> | |||
<div id="content"> | |||
<div style="margin-bottom: 10px; font-size: 40px; color: #777;">${ "Done!" | translate }</div> | |||
<a href="javascript:void(0)" onclick="javascript:self.close(); return false;" style="color: #777;">${ "Close this window" | translate }</a> | |||
<span id="countdown" style="color:#777;"> | |||
${ "or wait 3 seconds." | translate } | |||
</span> | |||
</div> | |||
<script type="text/javascript"> | |||
setTimeout('countdown_func()', 1000); | |||
</script> | |||
</body> | |||
</html> | |||
{% endif %} |
@@ -1,69 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Content Settings" | translate }{% endblock %} | |||
{% block content %} | |||
<form id="content_settings" class="split" action="{% admin "content_settings" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
<p> | |||
<label for="posts_per_page">${ "Posts Per Page" | translate }</label> | |||
<input class="text" type="text" name="posts_per_page" value="${ site.posts_per_page | escape }" size="2" id="posts_per_page" /> | |||
</p> | |||
<p> | |||
<label for="feed_items">${ "Feed Posts Limit" | translate }</label> | |||
<input class="text" type="text" name="feed_items" value="${ site.feed_items | escape }" size="2" id="feed_items" /> | |||
</p> | |||
<p> | |||
<label for="feed_url">${ "Feed URL" | translate }</label> | |||
<input class="text" type="text" name="feed_url" value="${ site.feed_url | escape }" id="feed_url" /> | |||
<small> | |||
{% if site.clean_urls %} | |||
${ "Allows you to set an alternative URL for <code>/feed/</code>, e.g. your feed on <a href=\"http://feedburner.com/\">FeedBurner</a>." | translate } | |||
{% else %} | |||
${ "Allows you to set an alternative URL for <code>/?feed</code>, e.g. your feed on FeedBurner." | translate } | |||
{% endif %} | |||
</small> | |||
</p> | |||
<p> | |||
<label for="uploads_path">${ "Uploads Path" | translate }</label> | |||
<input class="text" type="text" name="uploads_path" value="${ site.uploads_path | escape }" id="uploads_path" /> | |||
<small> | |||
${ "The directory, relative to your Chyrp install, to upload files to. You can use <code>/../</code> to go up one directory." | translate } | |||
</small> | |||
</p> | |||
<p> | |||
<label for="enable_trackbacking">${ "Enable Trackbacking" | translate }</label> | |||
<input class="checkbox" type="checkbox" name="enable_trackbacking" id="enable_trackbacking"${ site.enable_trackbacking | checked } /> | |||
<small> | |||
${ "Trackbacking allows sites to notify you when they write a new entry, usually because they link to or reference yours." | translate } | |||
</small> | |||
</p> | |||
<p> | |||
<label for="send_pingbacks">${ "Send Pingbacks" | translate }</label> | |||
<input class="checkbox" type="checkbox" name="send_pingbacks" id="send_pingbacks"${ site.send_pingbacks | checked } /> | |||
<small> | |||
${ "Attempts to notify sites linked to from your posts. It'll slow down things a bit when you submit them, depending on how many links you've got in it." | translate } | |||
</small> | |||
</p> | |||
<p> | |||
<label for="enable_xmlrpc">${ "Enable XML-RPC Support" | translate }</label> | |||
<input class="checkbox" type="checkbox" name="enable_xmlrpc" id="enable_xmlrpc"${ site.enable_xmlrpc | checked } /> | |||
<small> | |||
${ "XML-RPC support allows for remote access to your site. This allows you to use remote clients (e.g., <a href=\"http://www.red-sweater.com/marsedit/\">MarsEdit</a> or <a href=\"http://flickr.com/help/blogging/\">Flickr</a>) to create/edit content on your site." | translate } | |||
</small> | |||
</p> | |||
<p> | |||
<label for="enable_ajax">${ "Enable Inline Post Management" | translate }</label> | |||
<input class="checkbox" type="checkbox" name="enable_ajax" id="enable_ajax"${ site.enable_ajax | checked } /> | |||
</p> | |||
<p class="buttons"> | |||
<button type="submit" class="yay"> | |||
<img src="$theme_url/images/icons/success.png" alt="success" />${ "Update" | translate } | |||
</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,60 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Delete Group “%s”?" | translate | format(group.name | escape) }{% endblock %} | |||
{% block content %} | |||
<h1>${ "Are you sure you want to delete the “%s” group?" | translate | format(group.name | escape) }</h1> | |||
<form class="delete{% if group.id == visitor.group.id %} confirm{% endif %}" action="{% admin "destroy_group" %}" method="post" accept-charset="utf-8"> | |||
<fieldset> | |||
<blockquote class="noitalic"> | |||
{% if group.members %} | |||
<h2>${ "Members:" | translate }</h2> | |||
<ul> | |||
{% for member in group.members %} | |||
<li>${ member.full_name | fallback(member.login) }</li> | |||
{% endfor %} | |||
</ul> | |||
<br /> | |||
{% if groups %} | |||
<h2 class="inline">${ "Move members to:" | translate }</h2> | |||
<select name="move_group" id="move_group" class="big2"> | |||
{% for group in groups %} | |||
<option value="$group.id"${ group.id | option_selected(site.default_group) }>$group.name</option> | |||
{% endfor %} | |||
</select> | |||
<br /> | |||
{% endif %} | |||
<br /> | |||
{% endif %} | |||
{% if group.id == site.default_group and groups %} | |||
<h2 class="inline">${ "New default group:" | translate }</h2> | |||
<select name="default_group" id="default_group" class="big2"> | |||
{% for group in groups %} | |||
<option value="$group.id"${ group.id | option_selected(site.default_group) }>$group.name</option> | |||
{% endfor %} | |||
</select> | |||
<br /> | |||
<br /> | |||
{% endif %} | |||
{% if group.id == site.guest_group and groups %} | |||
<h2 class="inline">${ "New “guest” group:" | translate }</h2> | |||
<select name="guest_group" id="guest_group" class="big2"> | |||
{% for group in groups %} | |||
<option value="$group.id"${ group.id | option_selected(site.default_group) }>$group.name</option> | |||
{% endfor %} | |||
</select> | |||
<br /> | |||
<br /> | |||
{% endif %} | |||
</blockquote> | |||
<div class="center"> | |||
<button name="destroy" value="indubitably" class="center boo">${ "DESTROY!" | translate }</button> | |||
<button name="destroy" value="bollocks" type="submit" class="yay">${ "Cancel" | translate }</button> | |||
</div> | |||
<input type="hidden" name="id" value="$group.id" id="id" /> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,33 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Delete Page “%s”?" | translate | format(page.title | escape) }{% endblock %} | |||
{% block content %} | |||
<h1>${ "Are you sure you want to delete “%s”?" | translate | format(page.title) }</h1> | |||
<form class="delete" action="{% admin "destroy_page" %}" method="post" accept-charset="utf-8"> | |||
<fieldset> | |||
<blockquote> | |||
<h2>${ "Excerpt" | translate }</h2> | |||
${ page.body | truncate(500) } | |||
{% if page.children %} | |||
<br /> | |||
<h2><input type="checkbox" name="destroy_children{# OH, THE HORROR! #}" value="" id="destroy_children" /> ${ "Delete children?" | translate }</h2> | |||
<ul class="noitalic"> | |||
{% for child in page.children %} | |||
<li><a href="$child.url">$child.title</a></li> | |||
{% endfor %} | |||
</ul> | |||
{% endif %} | |||
</blockquote> | |||
<br /> | |||
<div class="center"> | |||
<button name="destroy" value="indubitably" class="center boo">${ "DESTROY!" | translate }</button> | |||
<button name="destroy" value="bollocks" type="submit" class="yay">${ "Cancel" | translate }</button> | |||
</div> | |||
<input type="hidden" name="id" value="$page.id" id="id" /> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,24 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Delete “%s”?" | translate | format(post.title | escape) }{% endblock %} | |||
{% block content %} | |||
<h1>${ "Are you sure you want to delete “%s”?" | translate | format(post.title) }</h1> | |||
<form class="delete" action="{% admin "destroy_post" %}" method="post" accept-charset="utf-8"> | |||
<fieldset> | |||
<blockquote> | |||
<h2>${ "Excerpt" | translate }</h2> | |||
$post.excerpt | |||
</blockquote> | |||
<br /> | |||
<div class="center"> | |||
<button name="destroy" value="indubitably" class="center boo">${ "DESTROY!" | translate }</button> | |||
<button name="destroy" value="bollocks" type="submit" class="yay">${ "Cancel" | translate }</button> | |||
</div> | |||
<input type="hidden" name="id" value="$post.id" id="id" /> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,89 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Delete User “%s”?" | translate | format(user.login | escape) }{% endblock %} | |||
{% block content %} | |||
<h1>${ "Are you sure you want to delete user “%s”?" | translate | format(user.login | escape) }</h1> | |||
<form class="delete" action="{% admin "destroy_user" %}" method="post" accept-charset="utf-8"> | |||
<fieldset> | |||
<blockquote class="noitalic"> | |||
<h2>${ "Information" | translate }</h2> | |||
<ul> | |||
{% if user.full_name %} | |||
<li><strong>${ "Full Name:" | translate }</strong> $user.full_name</li> | |||
{% endif %} | |||
<li><strong>${ "E-Mail:" | translate }</strong> $user.email</li> | |||
{% if user.website %} | |||
<li><strong>${ "Website:" | translate }</strong> <a href="$user.website">$user.website</a></li> | |||
{% endif %} | |||
<li><strong>${ "Group:" | translate }</strong> $user.group.name</li> | |||
</ul> | |||
<br /> | |||
{% if user.posts %} | |||
<h2>${ "Posts:" | translate }</h2> | |||
<ul> | |||
{% for post in user.posts %} | |||
<li><a href="$post.url">$post.title</a></li> | |||
{% endfor %} | |||
</ul> | |||
<br /> | |||
{% if users %} | |||
<h2 class="inline"> | |||
<input type="radio" name="posts" value="move" id="posts_move" /> | |||
${ "Attribute posts to:" | translate } | |||
</h2> | |||
<select name="move_posts" id="move_posts" class="big2"> | |||
{% for user in users %} | |||
<option value="$user.id">$user.full_name ($user.login)</option> | |||
{% endfor %} | |||
</select> | |||
<br /> | |||
{% endif %} | |||
<h2 class="inline"> | |||
<input type="radio" name="posts" value="delete" id="posts_delete" checked="checked" /> | |||
${ "Delete posts." | translate } | |||
</h2> | |||
<br /> | |||
<br /> | |||
{% endif %} | |||
{% if user.pages %} | |||
<h2>${ "Pages:" | translate }</h2> | |||
<ul> | |||
{% for page in user.pages %} | |||
<li><a href="$page.url">$page.title</a></li> | |||
{% endfor %} | |||
</ul> | |||
<br /> | |||
{% if users %} | |||
<h2 class="inline"> | |||
<input type="radio" name="pages" value="move" id="pages_move" /> | |||
${ "Attribute pages to:" | translate } | |||
</h2> | |||
<select name="move_pages" id="move_pages" class="big2"> | |||
{% for user in users %} | |||
<option value="$user.id">$user.full_name ($user.login)</option> | |||
{% endfor %} | |||
</select> | |||
<br /> | |||
{% endif %} | |||
<h2 class="inline"> | |||
<input type="radio" name="pages" value="delete" id="pages_delete" checked="checked" /> | |||
${ "Delete pages." | translate } | |||
</h2> | |||
<br /> | |||
<br /> | |||
{% endif %} | |||
${ trigger.call("delete_user_form") } | |||
</blockquote> | |||
<br /> | |||
<div class="center"> | |||
<button name="destroy" value="indubitably" class="center boo">${ "DESTROY!" | translate }</button> | |||
<button name="destroy" value="bollocks" type="submit" class="yay">${ "Cancel" | translate }</button> | |||
</div> | |||
<input type="hidden" name="id" value="$user.id" id="id" /> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,36 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Edit Group “%s”" | translate | format(group.name | escape) }{% endblock %} | |||
{% block content %} | |||
${ group.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" />'~ ("Delete" | translate), null, null, "button boo right") } | |||
<h1>${ "Editing Group “%s”" | translate | format(group.name | escape) }</h1> | |||
<form id="group_edit" class="split{% if group.id == visitor.group.id %} confirm{% endif %}" action="{% admin "update_group" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
<p> | |||
<label for="name">${ "Name" | translate }</label> | |||
<input class="text" type="text" name="name" value="${ group.name | escape }" id="name" /> | |||
</p> | |||
<h2>${ "Permissions" | translate }</h2> | |||
<p id="toggler"> | |||
</p> | |||
<hr class="js_enabled" /> | |||
{% for permission in permissions %} | |||
<p> | |||
<label for="permission_$permission.id">${ permission.name | translate }</label> | |||
<input class="checkbox" type="checkbox" name="permissions[$permission.id]" id="permission_$permission.id"{% if group.can(permission.id) %} checked="checked"{% endif %} /> | |||
</p> | |||
{% endfor %} | |||
<br /> | |||
<p> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Update" | translate }</button> | |||
</p> | |||
<input type="hidden" name="id" value="$group.id" id="id" /> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,16 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Edit “%s”" | translate | format(page.title | escape) }{% endblock %} | |||
{% block content %} | |||
${ page.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" />'~ ("Delete" | translate), null, null, "button boo right") } | |||
<h1>${ "Editing “%s”" | translate | format(page.title) }</h1> | |||
<form id="edit_form" action="{% admin "update_page" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
{% include "partials/page_fields.twig" %} | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
<input type="hidden" name="id" value="$page.id" id="id" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,17 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Edit “%s”" | translate | format(post.title | escape) }{% endblock %} | |||
{% block content %} | |||
${ post.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" />'~ ("Delete" | translate), null, null, "button boo right") } | |||
<h1>${ "Editing “%s”" | translate | format(post.title | escape) }</h1> | |||
<form id="edit_form" class="${ post.feather | escape(true) }" action="{% admin "update_post" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
{% include "partials/post_fields.twig" %} | |||
<input type="hidden" name="id" value="$post.id" id="id" /> | |||
<input type="hidden" name="feather" value="${ post.feather | escape(true) }" id="feather" /> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,57 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Edit User “%s”" | translate | format(user.login | escape) }{% endblock %} | |||
{% block content %} | |||
${ user.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" />'~ ("Delete" | translate), null, null, "button boo right") } | |||
<h1>${ "Editing User “%s”" | translate | format(user.login | escape) }</h1> | |||
<form id="user_edit" class="split" action="{% admin "update_user" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
<h2>${ "Information" | translate }</h2> | |||
<p> | |||
<label for="full_name">${ "Full Name" | translate }</label> | |||
<input class="text" type="text" name="full_name" value="${ user.full_name | escape }" id="full_name" /> | |||
</p> | |||
<p> | |||
<label for="email">${ "E-Mail" | translate }</label> | |||
<input class="text" type="text" name="email" value="${ user.email | escape }" id="email" /> | |||
</p> | |||
<p> | |||
<label for="website">${ "Website" | translate }</label> | |||
<input class="text" type="text" name="website" value="${ user.website | escape }" id="website" /> | |||
</p> | |||
<h2>${ "Settings" | translate }</h2> | |||
<p> | |||
<label for="login">${ "Login" | translate }</label> | |||
<input class="text" type="text" name="login" value="${ user.login | escape }" id="full_name" /> | |||
</p> | |||
<p> | |||
<label for="group">${ "Group" | translate }</label> | |||
<select name="group" id="group"> | |||
{% for group in groups %} | |||
<option value="$group.id"${ group.id | option_selected(user.group_id) }>$group.name</option> | |||
{% endfor %} | |||
</select> | |||
</p> | |||
<p> | |||
<label for="new_password1">${ "New Password?" | translate }</label> | |||
<input class="text" type="password" name="new_password1" value="" id="new_password1" /> | |||
</p> | |||
<p> | |||
<label for="new_password2">${ "Confirm" | translate }</label> | |||
<input class="text" type="password" name="new_password2" value="" id="new_password2" /> | |||
</p> | |||
${ trigger.call("edit_user_fields", user) } | |||
<br /> | |||
<p> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Update" | translate }</button> | |||
</p> | |||
<input type="hidden" name="id" value="$user.id" id="id" /> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,62 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Export" | translate }{% endblock %} | |||
{% block content %} | |||
<h2>${ "What would you like to export?" | translate }</h2> | |||
<form id="export_form" class="split" action="{% admin "export" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
<p> | |||
<label for="posts">${ "Posts" | translate }</label> | |||
<input class="checkbox" type="checkbox" name="posts" value="" id="posts" checked="checked" /> | |||
<small> | |||
${ "filter:" | translate } | |||
<input class="text" type="text" name="filter_posts" value="" id="filter_posts" /> | |||
<a href="{% admin "help&id=filtering_results" %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
${ "(optional)" | translate } | |||
</small> | |||
</p> | |||
<p> | |||
<label for="pages">${ "Pages" | translate }</label> | |||
<input class="checkbox" type="checkbox" name="pages" value="" id="pages" checked="checked" /> | |||
<small> | |||
${ "filter:" | translate } | |||
<input class="text" type="text" name="filter_pages" value="" id="filter_pages" /> | |||
<a href="{% admin "help&id=filtering_results" %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
${ "(optional)" | translate } | |||
</small> | |||
</p> | |||
<p> | |||
<label for="groups">${ "Groups" | translate }</label> | |||
<input class="checkbox" type="checkbox" name="groups" value="" id="groups" checked="checked" /> | |||
<small> | |||
${ "filter:" | translate } | |||
<input class="text" type="text" name="filter_groups" value="" id="filter_groups" /> | |||
<a href="{% admin "help&id=filtering_results" %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
${ "(optional)" | translate } | |||
</small> | |||
</p> | |||
<p> | |||
<label for="users">${ "Users" | translate }</label> | |||
<input class="checkbox" type="checkbox" name="users" value="" id="users" checked="checked" /> | |||
<span class="sub"> | |||
${ "(warning: this also exports the hashed passwords, keep it safe)" | translate } | |||
</span> | |||
<small> | |||
${ "filter:" | translate } | |||
<input class="text" type="text" name="filter_users" value="" id="filter_users" /> | |||
<a href="{% admin "help&id=filtering_results" %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
${ "(optional)" | translate } | |||
</small> | |||
</p> | |||
${ trigger.call("export_choose") } | |||
<p class="buttons"> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Export" | translate }</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,49 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Feathers" | translate }{% endblock %} | |||
{% block content %} | |||
<div class="enable feather left"> | |||
<h2>${ "Enabled" | translate }</h2> | |||
<ul class="extend"> | |||
{% for safename, feather in enabled_feathers | items %} | |||
<li class="$safename"> | |||
<a class="$safename info_link" href="javascript:void(0)"><img src="$theme_url/images/icons/info.png" class="info right" /></a> | |||
{% if feather.help %} | |||
<a href="{% admin "help&id="~feather.help %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
{% endif %} | |||
${ "<a href=\"%s\">%s</a> v%s <span class=\"sub\">by %s</span>" | translate | format(feather.url, feather.name | translate(safename), feather.version, feather.author.link) } | |||
<div class="expand"> | |||
<div class="description"> | |||
$feather.description {# translation is done in the controller #} | |||
</div> | |||
<noscript><a class="enable_button" href="{% admin "disable&feather="~safename %}">${ "Disable" | translate }</a></noscript> | |||
</div> | |||
</li> | |||
{% endfor %} | |||
</ul> | |||
</div> | |||
<div class="disable feather right"> | |||
<h2>${ "Disabled" | translate }</h2> | |||
<ul class="extend"> | |||
{% for safename, feather in disabled_feathers | items %} | |||
<li class="$safename"> | |||
<a class="$safename info_link" href="javascript:void(0)"><img src="$theme_url/images/icons/info.png" class="info right" /></a> | |||
{% if feather.help %} | |||
<a href="{% admin "help&id="~feather.help %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
{% endif %} | |||
${ "<a href=\"%s\">%s</a> v%s <span class=\"sub\">by %s</span>" | translate | format(feather.url, feather.name | translate(safename), feather.version, feather.author.link) } | |||
<div class="expand"> | |||
<div class="description"> | |||
$feather.description {# translation is done in the controller #} | |||
</div> | |||
<noscript><a class="disable_button" href="{% admin "enable&feather="~safename %}">${ "Enable" | translate }</a></noscript> | |||
</div> | |||
</li> | |||
{% endfor %} | |||
</ul> | |||
</div> | |||
<div class="clear tip_here"></div> | |||
<br /> | |||
<a class="button right" href="http://chyrp.net/extend/type/feather">${ "Get More Feathers ›" | translate }</a> | |||
{% endblock %} |
@@ -1,60 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Site Configuration" | translate }{% endblock %} | |||
{% block content %} | |||
<form id="general_settings" class="split" action="{% admin "general_settings" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
<p> | |||
<label for="name">${ "Site Name" | translate }</label> | |||
<input class="text" type="text" name="name" value="${ site.name | escape }" id="name" /> | |||
</p> | |||
<p> | |||
<label for="description">${ "Description" | translate }</label> | |||
<textarea name="description" rows="2" cols="40">${ site.description | escape(false, false) }</textarea> | |||
</p> | |||
<p> | |||
<label for="chyrp_url">${ "Chyrp URL" | translate }</label> | |||
<input class="text" type="text" name="chyrp_url" value="${ site.chyrp_url | escape }" id="chyrp_url" /> | |||
</p> | |||
<p> | |||
<label for="url"> | |||
${ "Alternate URL" | translate } | |||
<span class="sub">${ "(optional)" | translate }</span> | |||
</label> | |||
<input class="text" type="text" name="url" value="{% if site.url != site.chyrp_url %}${ site.url | escape }{% endif %}" id="url" /> | |||
<a href="{% admin "help&id=alternate_urls" %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
<small> | |||
${ "Enter an alternate address here if you want your homepage URL to be different from the URL where Chyrp is normally available." | translate } | |||
</small> | |||
</p> | |||
<p> | |||
<label for="email">${ "Contact E-Mail Address" | translate }</label> | |||
<input class="text" type="text" name="email" value="${ site.email | escape }" id="email" /> | |||
</p> | |||
<p> | |||
<label for="timezone">${ "What time is it?" | translate }</label> | |||
<select name="timezone" id="timezone"> | |||
{% for zone in timezones %} | |||
<option value="$zone.name"${ zone.name | option_selected(site.timezone) }>${ zone.now | strftime("%m/%d/%y %H:%M" | translate) } — ${ zone.name | replace("_", " ") | replace("St ", "St. ") }</option> | |||
{% endfor %} | |||
</select> | |||
</p> | |||
<p> | |||
<label for="locale">${ "Language" | translate }</label> | |||
<select name="locale" id="locale"> | |||
{% for locale in locales %} | |||
<option value="$locale.code"${ locale.code | option_selected(site.locale) }>$locale.name</option> | |||
{% endfor %} | |||
<option value="en_US"${ "en_US" | option_selected(site.locale) }>English (US)</option> | |||
</select> | |||
</p> | |||
<p class="buttons"> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Update" | translate }</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,176 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Import" | translate }{% endblock %} | |||
{% block content %} | |||
<h2>Chyrp</h2> | |||
<form id="import_chyrp_form" class="split" action="{% admin "import_chyrp" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
<p> | |||
<label for="posts_file">${ "Posts .atom File" | translate }</label> | |||
<input type="file" name="posts_file" value="" id="posts_file" /> | |||
</p> | |||
<p> | |||
<label for="pages_file">${ "Pages .atom File" | translate }</label> | |||
<input type="file" name="pages_file" value="" id="pages_file" /> | |||
</p> | |||
<p> | |||
<label for="groups_file">${ "Groups .yaml File" | translate }</label> | |||
<input type="file" name="groups_file" value="" id="groups_file" /> | |||
</p> | |||
<p> | |||
<label for="users_file">${ "Users .yaml File" | translate }</label> | |||
<input type="file" name="users_file" value="" id="users_file" /> | |||
</p> | |||
<p> | |||
<label for="media_url"> | |||
${ "What URL is used for embedded media?" | translate } | |||
<span class="sub">${ "(optional)" | translate }</span> | |||
</label> | |||
<input class="text" type="text" name="media_url" value="" id="media_url" /> | |||
<small> | |||
${ "Usually something like <code>http://example.com/uploads/</code>." | translate } | |||
</small> | |||
</p> | |||
${ trigger.call("import_choose") } | |||
<p class="buttons"> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Import" | translate }</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
<br /> | |||
<hr /> | |||
<br /> | |||
<h2>WordPress</h2> | |||
<form id="import_wordpress_form" class="split" action="{% admin "import_wordpress" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
<p> | |||
<label for="xml_file">${ "eXtended .XML File" | translate }</label> | |||
<input type="file" name="xml_file" value="" id="xml_file" /> | |||
</p> | |||
<p> | |||
<label for="media_url"> | |||
${ "What URL is used for embedded media?" | translate } | |||
<span class="sub">${ "(optional)" | translate }</span> | |||
</label> | |||
<input class="text" type="text" name="media_url" value="" id="media_url" /> | |||
<small> | |||
${ "Usually something like <code>http://example.com/wp-content/uploads/</code>." | translate } | |||
</small> | |||
</p> | |||
<p class="buttons"> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Import" | translate }</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
<br /> | |||
<hr /> | |||
<br /> | |||
<h2>Tumblr</h2> | |||
<form id="import_tumblr_form" class="split" action="{% admin "import_tumblr" %}" method="post" accept-charset="utf-8"> | |||
<fieldset> | |||
<p> | |||
<label for="tumblr_url">${ "Your Tumblr URL" | translate }</label> | |||
<input class="text" type="text" name="tumblr_url" value="" id="tumblr_url" /> | |||
<small>${ "Note: Audio tumbles cannot be imported." | translate }</small> | |||
</p> | |||
<p class="buttons"> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Import" | translate }</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
<br /> | |||
<hr /> | |||
<br /> | |||
<h2>TextPattern</h2> | |||
<form id="import_textpattern_form" class="split" action="{% admin "import_textpattern" %}" method="post" accept-charset="utf-8"> | |||
<fieldset> | |||
<p> | |||
<label for="host">${ "Host" | translate }</label> | |||
<input class="text" type="text" name="host" value="localhost" id="host" /> | |||
</p> | |||
<p> | |||
<label for="username">${ "Username" | translate }</label> | |||
<input class="text" type="text" name="username" value="" id="username" /> | |||
</p> | |||
<p> | |||
<label for="password">${ "Password" | translate }</label> | |||
<input class="text" type="password" name="password" value="" id="password" /> | |||
</p> | |||
<p> | |||
<label for="database">${ "Database" | translate }</label> | |||
<input class="text" type="text" name="database" value="" id="database" /> | |||
</p> | |||
<p> | |||
<label for="prefix">${ "Table Prefix" | translate }</label> | |||
<input class="text" type="text" name="prefix" value="" id="prefix" /> | |||
<span class="sub">${ "(if any)" | translate }</span> | |||
</p> | |||
<p> | |||
<label for="media_url"> | |||
${ "What URL is used for embedded media?" | translate } | |||
<span class="sub">${ "(optional)" | translate }</span> | |||
</label> | |||
<input class="text" type="text" name="media_url" value="" id="media_url" /> | |||
<small> | |||
${ "Usually something like <code>http://example.com/images/</code>." | translate } | |||
</small> | |||
</p> | |||
<p class="buttons"> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Import" | translate }</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
<br /> | |||
<hr /> | |||
<br /> | |||
<h2>MovableType</h2> | |||
<form id="import_movabletype_form" class="split" action="{% admin "import_movabletype" %}" method="post" accept-charset="utf-8"> | |||
<fieldset> | |||
<p> | |||
<label for="host">${ "Host" | translate }</label> | |||
<input class="text" type="text" name="host" value="localhost" id="host" /> | |||
</p> | |||
<p> | |||
<label for="username">${ "Username" | translate }</label> | |||
<input class="text" type="text" name="username" value="" id="username" /> | |||
</p> | |||
<p> | |||
<label for="password">${ "Password" | translate }</label> | |||
<input class="text" type="password" name="password" value="" id="password" /> | |||
</p> | |||
<p> | |||
<label for="database">${ "Database" | translate }</label> | |||
<input class="text" type="text" name="database" value="" id="database" /> | |||
</p> | |||
<p> | |||
<label for="media_url"> | |||
${ "What URL is used for embedded media?" | translate } | |||
<span class="sub">${ "(optional)" | translate }</span> | |||
</label> | |||
<input class="text" type="text" name="media_url" value="" id="media_url" /> | |||
<small> | |||
${ "Usually something like <code>http://example.com/images/</code>." | translate } | |||
</small> | |||
</p> | |||
<p class="buttons"> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Import" | translate }</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
${ trigger.call("import_choose") } | |||
{% endblock %} |
@@ -1,47 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Manage Groups" | translate }{% endblock %} | |||
{% block content %} | |||
<h2>${ "Need more detail?" | translate }</h2> | |||
<form class="detail" action="index.php" method="get" accept-charset="utf-8"> | |||
<fieldset> | |||
<input type="hidden" name="action" value="manage_groups" /> | |||
{% if visitor.group.can("add_group") %} | |||
<a href="{% admin "new_group" %}" class="button yay right"> | |||
<img src="$theme_url/images/icons/add.png" alt="add" /> ${ "New Group" | translate } | |||
</a> | |||
{% endif %} | |||
<div class="pad"> | |||
<h3>${ "Search all groups for user…" | translate }</h3> | |||
<input class="text" type="text" name="search" value="${ GET.search | escape }" id="search" /> <button type="submit" class="inline">${ "Search →" | translate }</button> | |||
</div> | |||
</fieldset> | |||
</form> | |||
<br /> | |||
<h2>${ "Groups" | translate }</h2> | |||
{% for group in groups.paginated %} | |||
<div class="box"> | |||
<h1> | |||
<span class="right"> | |||
${ group.edit_link('<img src="'~ theme_url ~'/images/icons/edit.png" alt="edit" /> '~("edit" | translate)) } | |||
${ group.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" /> '~("delete" | translate)) } | |||
</span> | |||
{% if group.id == site.guest_group %} | |||
${ "“%s” is the group for guests." | translate | format(group.name) } | |||
{% elseif group.id == site.default_group %} | |||
${ "“%s” is the default group and has %d <a href=\"%s\">member</a>." | translate_plural("“%s” is the default group and has %d <a href=\"%s\">members</a>.", group.size) | format(group.name, group.size, route.url("/admin/?action=manage_users&query=group%3A"~group.name)) } | |||
{% else %} | |||
${ "“%s” has %d <a href=\"%s\">member</a>." | translate_plural("“%s” has %d <a href=\"%s\">members</a>.", group.size) | format(group.name, group.size, route.url("/admin/?action=manage_users&query=group%3A"~group.name)) } | |||
{% endif %} | |||
</h1> | |||
</div> | |||
{% endfor %} | |||
{% if groups.paginated and groups.pages > 1 %} | |||
<div class="pagination"> | |||
$groups.next_link | |||
$groups.prev_link | |||
<span class="pages">${ "Page %d of %d" | translate | format(groups.page, groups.pages) }</span> | |||
</div> | |||
{% endif %} | |||
{% endblock %} |
@@ -1,91 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Manage Pages" | translate }{% endblock %} | |||
{% block content %} | |||
<h2>${ "Need more detail?" | translate }</h2> | |||
<form class="detail" action="index.php" method="get" accept-charset="utf-8"> | |||
<fieldset> | |||
<input type="hidden" name="action" value="manage_pages" /> | |||
<div class="pad"> | |||
<h3> | |||
${ "Search…" | translate } | |||
<a href="{% admin "help&id=filtering_results" %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
</h3> | |||
<input class="text" type="text" name="query" value="${ GET.query | escape }" id="query" /> <button type="submit" class="inline">${ "Search →" | translate }</button> | |||
</div> | |||
</fieldset> | |||
</form> | |||
<br /> | |||
<h2>{% if GET.query %}${ "Search Results" | translate }{% else %}${ "Last 25 Pages" | translate }{% endif %}</h2> | |||
<table border="0" cellspacing="0" cellpadding="0" class="wide"> | |||
<thead> | |||
<tr class="head"> | |||
<th>${ "Title" | translate }</th> | |||
<th>${ "Created" | translate }</th> | |||
<th>${ "Last Updated" | translate }</th> | |||
<th>${ "Author" | translate }</th> | |||
${ trigger.call("manage_pages_column_header") } | |||
<th colspan="2">${ "Controls" | translate }</th> | |||
</tr> | |||
</thead> | |||
<tbody> | |||
{% for page in pages.paginated %} | |||
<tr id="page_$page.id" class="page{% if loop.last %} last{% endif %}"> | |||
<td class="main"><a href="$page.url">${ page.title | truncate }</a></td> | |||
<td>${ page.created_at | strftime }</td> | |||
<td>{% if page.updated %}${ page.updated_at | strftime }{% else %}<span class="sub">${ "never" | translate }</span>{% endif %}</td> | |||
<td>$page.user.login</td> | |||
${ trigger.call("manage_pages_column", page) } | |||
{% if page.editable and page.deletable %} | |||
<td class="controls">${ page.edit_link('<img src="'~ theme_url ~'/images/icons/edit.png" alt="edit" /> '~("edit" | translate)) }</td> | |||
<td class="controls">${ page.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" /> '~("delete" | translate)) }</td> | |||
{% else %} | |||
${ page.edit_link('<img src="'~ theme_url ~'/images/icons/edit.png" alt="edit" /> '~("edit" | translate), '<td class="controls" colspan="2">', '</td>') } | |||
${ page.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" /> '~("delete" | translate), '<td class="controls" colspan="2">', '</td>') } | |||
{% endif %} | |||
</tr> | |||
{% else %} | |||
<tr class="last"> | |||
<td colspan="6" class="center"><span class="sub">${ "(none)" | translate }</span></td> | |||
</tr> | |||
{% endfor %} | |||
</tbody> | |||
</table> | |||
{% if pages.paginated and pages.pages > 1 %} | |||
<br /> | |||
<div class="pagination"> | |||
$pages.next_link | |||
$pages.prev_link | |||
<span class="pages">${ "Page %d of %d" | translate | format(pages.page, pages.pages) }</span> | |||
</div> | |||
{% endif %} | |||
{% if pages.total %} | |||
<br /> | |||
<h2>${ "Reorder Pages" | translate }</h2> | |||
<form id="reorder_pages" action="{% admin "reorder_pages" %}" method="post"> | |||
<ul class="sort_pages"> | |||
{% for item in theme.pages_list %} | |||
<li class="page-item" id="page_list_$item.page.id"> | |||
<noscript><input type="text" size="2" name="list_order[$item.page.id]" value="$item.page.list_order" class="center" /></noscript> | |||
<div>$item.page.title</div> | |||
{% if item.has_children %}<ul>{% endif %} | |||
{% if not item.has_children %}</li>{% endif %} | |||
{% for ul, li in item.end_tags %} | |||
$ul | |||
$li | |||
{% endfor %} | |||
{% endfor %} | |||
</ul> | |||
<noscript> | |||
<div class="buttons"> | |||
<button type="submit" class="yay"> | |||
<img src="$theme_url/images/icons/success.png" alt="success" />${ "Reorder" | translate } | |||
</button> | |||
</div> | |||
</noscript> | |||
</form> | |||
{% endif %} | |||
{% endblock %} |
@@ -1,74 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Manage Posts" | translate }{% endblock %} | |||
{% block content %} | |||
<h2>${ "Need more detail?" | translate }</h2> | |||
<form class="detail" action="index.php" method="get" accept-charset="utf-8"> | |||
<fieldset> | |||
<input type="hidden" name="action" value="manage_posts" /> | |||
<div class="left pad margin-right"> | |||
<h3> | |||
${ "Search…" | translate } | |||
<a href="{% admin "help&id=filtering_results" %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
</h3> | |||
<input class="text" type="text" name="query" value="${ GET.query | escape }" id="query" /> <button type="submit" class="inline">${ "Search →" | translate }</button> | |||
</div> | |||
<div class="left pad"> | |||
<h3>${ "Browse by month:" | translate }</h3> | |||
<select name="month"> | |||
<option value="">----------</option> | |||
{% for archive in theme.archives_list %} | |||
<option value="${ archive.when | strftime("%Y-%m") }"${ GET.month | option_selected(archive.when | strftime("%Y-%m")) }>${ archive.when | strftime("%B %Y") } ($archive.count)</option> | |||
{% endfor %} | |||
</select> | |||
<button type="submit" class="inline">${ "Show →" | translate }</button> | |||
</div> | |||
<div class="clear"></div> | |||
</fieldset> | |||
</form> | |||
<br /> | |||
<h2>{% if GET.query %}${ "Search Results" | translate }{% else %}${ "Last 25 Posts" | translate }{% endif %}</h2> | |||
<table border="0" cellspacing="0" cellpadding="0" class="wide"> | |||
<thead> | |||
<tr class="head"> | |||
<th>${ "Title" | translate }</th> | |||
<th>${ "Posted" | translate }</th> | |||
<th>${ "Status" | translate }</th> | |||
<th>${ "Author" | translate }</th> | |||
${ trigger.call("manage_posts_column_header") } | |||
<th colspan="2">${ "Controls" | translate }</th> | |||
</tr> | |||
</thead> | |||
<tbody> | |||
{% for post in posts.paginated %} | |||
<tr id="post_$post.id" class="post $post.status_class{% if loop.last %} last{% endif %}"> | |||
<td class="main"><a href="$post.url">${ post.title | truncate }</a></td> | |||
<td>${ post.created_at | strftime }</td> | |||
<td>$post.status_name</td> | |||
<td>$post.user.login</td> | |||
${ trigger.call("manage_posts_column", post) } | |||
{% if post.editable and post.deletable %} | |||
<td class="controls">${ post.edit_link('<img src="'~ theme_url ~'/images/icons/edit.png" alt="edit" /> '~("edit" | translate)) }</td> | |||
<td class="controls">${ post.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" /> '~("delete" | translate)) }</td> | |||
{% elseif post.editable or post.deletable %} | |||
${ post.edit_link('<img src="'~ theme_url ~'/images/icons/edit.png" alt="edit" /> '~("edit" | translate), '<td class="controls" colspan="2">', '</td>') } | |||
${ post.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" /> '~("delete" | translate), '<td class="controls" colspan="2">', '</td>') } | |||
{% endif %} | |||
</tr> | |||
{% else %} | |||
<tr class="last"> | |||
<td colspan="6" class="center"><span class="sub">${ "(none)" | translate }</span></td> | |||
</tr> | |||
{% endfor %} | |||
</tbody> | |||
</table> | |||
{% if posts.paginated and posts.pages > 1 %} | |||
<br /> | |||
<div class="pagination"> | |||
$posts.next_link | |||
$posts.prev_link | |||
<span class="pages">${ "Page %d of %d" | translate | format(posts.page, posts.pages) }</span> | |||
</div> | |||
{% endif %} | |||
{% endblock %} |
@@ -1,74 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Manage Users" | translate }{% endblock %} | |||
{% block content %} | |||
<h2>${ "Need more detail?" | translate }</h2> | |||
<form class="detail" action="index.php" method="get" accept-charset="utf-8"> | |||
<fieldset> | |||
<input type="hidden" name="action" value="manage_users" /> | |||
{% if visitor.group.can("add_user") %} | |||
<a href="{% admin "new_user" %}" class="button yay right"> | |||
<img src="$theme_url/images/icons/add.png" alt="add" /> ${ "New User" | translate } | |||
</a> | |||
{% endif %} | |||
<div class="pad"> | |||
<h3> | |||
${ "Search…" | translate } | |||
<a href="{% admin "help&id=filtering_results" %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
</h3> | |||
<input class="text" type="text" name="query" value="${ GET.query | escape }" id="query" /> <button type="submit" class="inline">${ "Search →" | translate }</button> | |||
</div> | |||
</fieldset> | |||
</form> | |||
<br /> | |||
<h2>${ "Users" | translate }</h2> | |||
<table border="0" cellspacing="0" cellpadding="0" class="wide"> | |||
<thead> | |||
<tr class="head"> | |||
<th>${ "Name" | translate }</th> | |||
<th>${ "Group" | translate }</th> | |||
<th>${ "Joined" | translate }</th> | |||
<th>${ "Website" | translate }</th> | |||
${ trigger.call("manage_users_column_header") } | |||
<th colspan="2">${ "Controls" | translate }</th> | |||
</tr> | |||
</thead> | |||
<tbody> | |||
{% for user in users.paginated %} | |||
<tr id="user_$user.id" class="user{% if loop.last %} last{% endif %}"> | |||
<td class="main"> | |||
{% if user.full_name != "" %} | |||
<a href="mailto:$user.email">$user.full_name</a> <span class="sub">($user.login)</span> | |||
{% else %} | |||
<a href="mailto:$user.email">$user.login</a> | |||
{% endif %} | |||
</td> | |||
<td>${ user.group.name | escape }</td> | |||
<td>${ user.joined_at | strftime }</td> | |||
<td>{% if user.website != "" %}<a href="$user.website">$user.website</a>{% endif %}</td> | |||
${ trigger.call("manage_users_column", user) } | |||
{% if user.editable and user.deletable %} | |||
<td class="controls">${ user.edit_link('<img src="'~ theme_url ~'/images/icons/edit.png" alt="edit" /> '~("edit" | translate)) }</td> | |||
<td class="controls">${ user.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" /> '~("delete" | translate)) }</td> | |||
{% else %} | |||
${ user.edit_link('<img src="'~ theme_url ~'/images/icons/edit.png" alt="edit" /> '~("edit" | translate), '<td class="controls" colspan="2">', '</td>') } | |||
${ user.delete_link('<img src="'~ theme_url ~'/images/icons/delete.png" alt="delete" /> '~("delete" | translate), '<td class="controls" colspan="2">', '</td>') } | |||
{% endif %} | |||
</tr> | |||
{% else %} | |||
<tr class="last"> | |||
<td colspan="5" class="center"><span class="sub">${ "(none)" | translate }</span></td> | |||
</tr> | |||
{% endfor %} | |||
</tbody> | |||
</table> | |||
{% if users.paginated and users.pages > 1 %} | |||
<br /> | |||
<div class="pagination"> | |||
$users.next_link | |||
$users.prev_link | |||
<span class="pages">${ "Page %d of %d" | translate | format(users.page, users.pages) }</span> | |||
</div> | |||
{% endif %} | |||
{% endblock %} |
@@ -1,71 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Modules" | translate }{% endblock %} | |||
{% block content %} | |||
<div class="enable module left"> | |||
<h2>${ "Enabled" | translate }</h2> | |||
<ul class="extend"> | |||
{% for safename, module in enabled_modules | items %} | |||
<li class="${ module.classes | join(" ") }" id="module_$safename"> | |||
<a class="$safename info_link" href="javascript:void(0)"><img src="$theme_url/images/icons/info.png" class="info right" /></a> | |||
{% if module.help %} | |||
<a href="{% admin "help&id="~module.help %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
{% endif %} | |||
${ "<a href=\"%s\">%s</a> v%s <span class=\"sub\">by %s</span>" | translate | format(module.url, module.name | translate(safename), module.version, module.author.link) } | |||
<div class="expand"> | |||
<div class="description{% if module.dependencies_needed %} expanded{% endif %}"> | |||
$module.description {# translation is done in the controller #} | |||
<p class="dependencies_message"{% if not module.dependencies_needed %} style="display: none"{% endif %}> | |||
${ "This Module requires the following Modules to be enabled:" | translate } | |||
</p> | |||
<ul class="dependencies_list"{% if not module.dependencies_needed %} style="display: none"{% endif %}> | |||
{% for dependency in module.dependencies_needed %} | |||
<li class="$dependency">$dependency</li> | |||
{% endfor %} | |||
</ul> | |||
</div> | |||
{% if not module.dependencies_needed %} | |||
<noscript><a class="enable_button" href="{% admin "disable&module="~safename %}">${ "Disable" | translate }</a></noscript> | |||
{% endif %} | |||
</div> | |||
</li> | |||
{% endfor %} | |||
</ul> | |||
</div> | |||
<div class="disable module right"> | |||
<h2>${ "Disabled" | translate }</h2> | |||
<ul class="extend"> | |||
{% for safename, module in disabled_modules | items %} | |||
<li class="${ module.classes | join(" ") }" id="module_$safename"> | |||
<a class="$safename info_link" href="javascript:void(0)"><img src="$theme_url/images/icons/info.png" class="info right" /></a> | |||
{% if module.help %} | |||
<a href="{% admin "help&id="~module.help %}" class="help emblem"><img src="$theme_url/images/icons/help.png" alt="help" /></a> | |||
{% endif %} | |||
${ "<a href=\"%s\">%s</a> v%s <span class=\"sub\">by %s</span>" | translate | format(module.url, module.name | translate(safename), module.version, module.author.link) } | |||
<div class="expand"> | |||
<div class="description{% if module.dependencies_needed %} expanded{% endif %}"> | |||
$module.description {# translation is done in the controller #} | |||
<p class="dependencies_message"{% if not module.dependencies_needed %} style="display: none"{% endif %}> | |||
${ "This Module requires the following Modules to be enabled:" | translate } | |||
</p> | |||
<ul class="dependencies_list"{% if not module.dependencies_needed %} style="display: none"{% endif %}> | |||
{% for dependency in module.dependencies_needed %} | |||
<li class="$dependency">$dependency</li> | |||
{% endfor %} | |||
</ul> | |||
</div> | |||
{% if not module.dependencies_needed %} | |||
<noscript><a class="disable_button" href="{% admin "enable&module="~safename %}">${ "Enable" | translate }</a></noscript> | |||
{% endif %} | |||
</div> | |||
</li> | |||
{% endfor %} | |||
</ul> | |||
</div> | |||
<div class="clear"></div> | |||
<br /> | |||
<a class="button right" href="http://chyrp.net/extend/type/module">${ "Get More Modules ›" | translate }</a> | |||
{% endblock %} |
@@ -1,34 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "New Group" | translate }{% endblock %} | |||
{% block content %} | |||
<h1>${ "New Group" | translare }</h1> | |||
<form id="new_group" class="split" action="{% admin "add_group" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
<p> | |||
<label for="name">${ "Name" | translate }</label> | |||
<input class="text" type="text" name="name" value="" id="name" /> | |||
</p> | |||
<h2>${ "Permissions" | translate }</h2> | |||
<p id="toggler"> | |||
</p> | |||
<hr class="js_enabled" /> | |||
{% for permission in permissions %} | |||
<p> | |||
<label for="permission_$permission.id">${ permission.name | translate }</label> | |||
<input class="checkbox" type="checkbox" name="permissions[$permission.id]" id="permission_$permission.id" /> | |||
</p> | |||
{% endfor %} | |||
<br /> | |||
<p> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Add Group" | translate }</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,58 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Add User" | translate }{% endblock %} | |||
{% block content %} | |||
<h1>${ "New User" | translare }</h1> | |||
<form id="new_user" class="split" action="{% admin "add_user" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
<h2>${ "Settings" | translate }</h2> | |||
<p> | |||
<label for="login">${ "Login" | translate }</label> | |||
<input class="text" type="text" name="login" value="" id="full_name" /> | |||
</p> | |||
<p> | |||
<label for="group">${ "Group" | translate }</label> | |||
<select name="group" id="group"> | |||
<option value="$default_group.id">$default_group.name</option> | |||
{% for group in groups %} | |||
<option value="$group.id">$group.name</option> | |||
{% endfor %} | |||
</select> | |||
</p> | |||
<p> | |||
<label for="password1">${ "Password" | translate }</label> | |||
<input class="text" type="password" name="password1" value="" id="password1" /> | |||
</p> | |||
<p> | |||
<label for="password2">${ "Confirm" | translate }</label> | |||
<input class="text" type="password" name="password2" value="" id="password2" /> | |||
</p> | |||
<h2>${ "Information" | translate }</h2> | |||
<p> | |||
<label for="full_name">${ "Full Name" | translate }</label> | |||
<input class="text" type="text" name="full_name" value="" id="full_name" /> | |||
</p> | |||
<p> | |||
<label for="email">${ "E-Mail" | translate }</label> | |||
<input class="text" type="text" name="email" value="" id="email" /> | |||
</p> | |||
<p> | |||
<label for="website">${ "Website" | translate }</label> | |||
<input class="text" type="text" name="website" value="" id="website" /> | |||
</p> | |||
${ trigger.call("new_user_fields") } | |||
<br /> | |||
<p> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Add User" | translate }</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |
@@ -1,50 +0,0 @@ | |||
{% extends "layout.twig" %} | |||
{% block title %}${ "Route Settings" | translate }{% endblock %} | |||
{% block content %} | |||
<form id="route_settings" class="split" action="{% admin "route_settings" %}" method="post" accept-charset="utf-8" enctype="multipart/form-data"> | |||
<fieldset> | |||
<p> | |||
<label for="clean_urls">${ "Clean URLs?" | translate }</label> | |||
<input type="checkbox" name="clean_urls" id="clean_urls"${ site.clean_urls | checked } /> | |||
<span class="sub">${ "(recommended)" | translate }</span> | |||
<small> | |||
${ "Gives your site prettier urls." | translate }<br /> | |||
${ "Requires .htaccess support (pretty common). If you're unsure, it's safe to test and find out. Just come back and disable it if it breaks your site." | translate } | |||
</small> | |||
</p> | |||
<p> | |||
<label for="post_url"> | |||
${ "Post View URL" | translate } | |||
<span class="sub">${ "(requires clean URLs)" | translate }</span> | |||
</label> | |||
<input class="text code" type="text" name="post_url" value="${ site.post_url | escape }" size="30" id="post_url" /> | |||
</p> | |||
<div class="small"> | |||
<strong>${ "Syntax:" | translate }</strong> | |||
<ul> | |||
<li><code>(year)</code>: ${ "Year submitted" | translate } <span class="sub">${ "(ex. 2007)" | translate }</span></li> | |||
<li><code>(month)</code>: ${ "Month submitted" | translate } <span class="sub">${ "(ex. 12)" | translate }</span></li> | |||
<li><code>(day)</code>: ${ "Day submitted" | translate } <span class="sub">${ "(ex. 25)" | translate }</span></li> | |||
<li><code>(hour)</code>: ${ "Hour submitted" | translate } <span class="sub">${ "(ex. 03)" | translate }</span></li> | |||
<li><code>(minute)</code>: ${ "Minute submitted" | translate } <span class="sub">${ "(ex. 59)" | translate }</span></li> | |||
<li><code>(second)</code>: ${ "Second submitted" | translate } <span class="sub">${ "(ex. 30)" | translate }</span></li> | |||
<li><code>(id)</code>: ${ "Post ID" | translate }</li> | |||
<li><code>(author)</code>: ${ "Post author (username)" | translate } <span class="sub">${ "(ex. Alex)" | translate }</span></li> | |||
<li><code>(clean)</code>: ${ "The non-unique sanitized name" | translate } <span class="sub">${ "(ex. this_is_clean)" | translate }</span></li> | |||
<li><code>(url)</code>: ${ "The unique form of (clean)" | translate } <span class="sub">${ "(ex. this_one_is_taken_2)" | translate }</span></li> | |||
<li><code>(feather)</code>: ${ "The post's feather" | translate } <span class="sub">${ "(ex. text)" | translate }</span></li> | |||
<li><code>(feathers)</code>: ${ "The plural form of the post's feather" | translate } <span class="sub">${ "(ex. links)" | translate }</span></li> | |||
${ trigger.call("post_view_url_settings") } | |||
</ul> | |||
</div> | |||
<p class="buttons"> | |||
<button type="submit" class="yay"><img src="$theme_url/images/icons/success.png" alt="success" />${ "Update" | translate }</button> | |||
</p> | |||
<input type="hidden" name="hash" value="$site.secure_hashkey" id="hash" /> | |||
</fieldset> | |||
</form> | |||
{% endblock %} |