+ This section lists the applications made by the KXStudio Team.
+ You might also want to check:
+
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
|
+
+
+ |
+
+ |
 - |
+ Supports ArchLinux (Available in AUR) | +
 - |
+ Supports Debian (Available at the KXStudio Repositories) | +
 - |
+ Supports Ubuntu (Available at the KXStudio Repositories) | +
 - |
+ Supports all GNU/Linux systems in general (Binaries and Source Code available in the Downloads page) | +
 - |
+ Supports Mac OS (Package available in the Downloads page) | +
 - |
+ Supports Windows (Binaries available in the Downloads page) | +
+ Cadence-JackMeter is a digital peak meter for JACK.
+ It automatically connects itself to all application JACK output ports that are also connected to the system output.
+
+ This tool can be executed as 'cadence-jackmeter' for monitoring outputs or 'cadence-jackmeter -in' for monitoring inputs. +
+ + +
+ A screenshot follows:
+ 
+
+ This is a regular digital-audio peak meter as you probably have seen many times before.
+ Note that the peak values are based on programming data (0.0 <-> 1.0) and not dB.
+
+ The meter has small lines to guide you. The value of these lines are (from bottom to top): +
+
+ 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).
+ The JACK client name is 'M' for "meter". When you change connections in the JACK graph, Cadence-JackMeter will change accordingly.
+
+ Cadence-JackMeter is available in the KXStudio repositories and ArchLinux AUR ('cadence-tools' package in the KXStudio repositories, 'cadence' in AUR).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux and Windows (part of the Cadence bundle).
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+
+ Windows 32bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+ 
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ Cadence-JackSettings is a simple and easy-to-use configure dialog for jackdbus (either JACK2 or JACK1 + DBus patch).
+ It can configure JACK's driver and engine parameters (network not yet implemented), and it also supports LADISH studios.
+
+ This tool can be executed as 'cadence_jacksettings' or from within Cadence, + Catia and Claudia. +
+ + +
+ A screenshot of the first, "Engine" tab:
+ 
+
+ A screenshot of the second, "Driver" tab:
+ 
+
+ The third tab, "Network", is not implemented yet. +
+
+ You probably recognize some options from other JACK configure tools such as QjackCtl.
+ 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.
+
+ 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.
+ NOTE: Leaving a particular driver selected after closing the tool will result in that driver being used the next time JACK starts.
+
+ The options will be available (or not) according to your JACK version.
+ JACK1 and JACK2 options are different, so Cadence-JackSettings interface will change for them. Some set-ups might also have LADISH specific options.
+ (For this first release Cadence-JackSettings is targeted at JACK2 and some minor JACK1 options will be missing).
+
+ If you want a more in-depth explanation of what each option does, you can checkout your 'jackd' manual page or view it online here.
+ The first part of that manual relates to the 'Engine' options, then specific driver ones.
+ Remember that Cadence-JackSettings doesn't really uses 'jackd', but since we are both targeting JACK the options are the same.
+
+ NOTE: The settings are shared across jackdbus-capable applications (jack_control and ladiconf), but not QjackCtl.
+ 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.
+ We recommend using only Cadence and avoid (or uninstall) QjackCtl.
+
+ Cadence-JackSettings is available in the KXStudio repositories and ArchLinux AUR ('cadence-tools' package in the KXStudio repositories, 'cadence' in AUR).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux (part of the Cadence bundle).
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ Cadence-Logs is a small tool that shows JACK, A2J, LASH and LADISH logs in a multi-tab window.
+ 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.
+
+ This tool can be executed as 'cadence_logs' or within Catia and + Claudia from their 'Tools' menu. +
+ + +
+ A screenshot follows, showing the JACK log:
+ 
+
+ It couldn't be simpler: 4 tabs for the different logs and 2 buttons.
+ 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.
+ (As you can see in the screen-shot above the 'LASH' tab is missing, indicating that its log does not exist in the system).
+
+ The 'Close' button will, obviously, close the tool window.
+ The 'Purge all logs' button will empty all the available logs (it will not delete the files, but overwrite them). If a log file does not exist it will not be created.
+
+ 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.
+ The logs are actually files that exist within your home folder. The full filenames for each log are:
+
+ Cadence-Logs is available in the KXStudio repositories and ArchLinux AUR ('cadence-tools' package in the KXStudio repositories, 'cadence' in AUR).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux (part of the Cadence bundle).
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ Cadence-Render is a tool to record (or 'render') a JACK project using jack-capture, controlled by JACK Transport.
+ It supports a vast number of file types and can render in both realtime and freewheel modes.
+
+ This tool can be executed as 'cadence_render' or within Catia and
+ Claudia from their 'Tools' menu.
+ 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.
+
+ A screenshot follows:
+ 
+
+ You have two render modes: Realtime and Freewheel (more on that below).
+ 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.
+ 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.
+
+ 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.
+ The rest of the interface is pretty straight forward.
+
+ Cadence-Render uses jack-capture to do the actual recording in the background.
+ 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.
+ 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.
+ This makes it particularly useful to render projects in freewheel mode with apps that don't support it directly.
+
+ Changing the buffer size before recording might be useful if you use plugin automation in hosts that don't support per-sample automation.
+ 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.
+ 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.
+ 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).
+ Freewheel mode avoids these issues (see below).
+
+ 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. +
+
+ NOTE: We recommend the use of padding in your songs (ie, put some silence before the beginning and end of a song).
+ 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.
+ 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.
+
+ 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.
+ Freewheel is the "offline" version, where audio (and midi) is processed as fast as possible. You won't hear anything when in this mode.
+ 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.
+
+ 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.
+ This is also useful when your project gets too big and can no longer play in realtime without xruns.
+
+ 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).
+ This is because JACK is running faster than realtime, so any external events can't catch up in time.
+ We encourage you to use JACK-MIDI whenever possible. Not only does it allow freewheel rendering but also provides perfect timing between applications.
+
+ Cadence-Render is available in the KXStudio repositories and ArchLinux AUR ('cadence-tools' package in the KXStudio repositories, 'cadence' in AUR).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux (part of the Cadence bundle).
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ Cadence-XY Controller is a simple XY widget that sends and receives data from Jack MIDI.
+ It can send data through specific channels and has a MIDI Keyboard too.
+
+ This tool can be executed as 'cadence_xycontroller'. +
+ + +
+ A screenshot follows showing the piano, running under
+ 
+
+ Another screenshot, now running under Windows 8:
+ 
+
+ 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.
+ 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.
+
+ There's also a MIDI-keyboard that is usually hidden (use "Settings" menu, "Show MIDI Keyboard" to show or hide it).
+ You can use the mouse or keyboard to trigger notes. The keyboard uses a 'qwerty' layout.
+
+ The first thing to do after starting this tool is to make the proper JACK connections so that it outputs the data somewhere (Catia does the job nicely).
+
+ Cadence-XY Controller can both receive and send MIDI data. This data will not pass-through, which is intentional and not a design failure.
+ 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.
+
+ MIDI data will be sent whenever the keyboard or XY cursor changes. When everything is stationary, no data is sent.
+ MIDI-Keyboard actions will send regular MIDI note-on/offs. XY cursor changes will send MIDI data that look like this:
+
+ Status: 0xB0 + channel - 1
+ Control: 0x01 (Modulation, as defined in "X Controls")
+ Value: X value percentage * 127 / 100
+
+
+ Cadence-XYController is available in the KXStudio repositories and ArchLinux AUR ('cadence-tools' package in the KXStudio repositories, 'cadence' in AUR).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux and Windows (part of the Cadence bundle).
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+
+ Windows 32bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ Cadence is a set of tools useful for audio production.
+ Cadence itself is also an application (the main one), which this page will document.
+ There are other applications that are part of the Cadence suite, they are usually named as the "Cadence tools".
+ They are:
+
+ Some of these also have sub-tools, such as Cadence-JackMeter and Claudia-Launcher.
+ Each of these sub-tools is properly documented in its respective page.
+
+ Cadence can be executed as 'cadence'.
+ Running it with '--minimized' makes it start minimized in the systray.
+
+ A screenshot of the first, "System" tab:
+ (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)
+ 
+
+ A screenshot of the second, "Tools" tab:
+ (The screenshots are clickable, which will start their respective tools)
+ 
+
+ A screenshot of the third, "Tweaks" tab:
+ (This tab allows you to carry out some audio and system related tasks. Some options are not available on certain systems)
+ 
+
+ Cadence is available in the KXStudio repositories and ArchLinux AUR (both with 'cadence' package name).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux and Windows.
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+
+ Windows 32bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ This is a dummy page, a placeholder for when the real page is written. +
+ + ++ TODO +
+ + ++ TODO +
+ + +
+ Carla is available in the KXStudio repositories and ArchLinux AUR (both with 'carla' package name).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux (part of the Carla bundle).
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ Carla is an audio plugin host, with support for many audio drivers and plugin formats.
+ It has some nice features like automation of parameters via MIDI CC (and send output back as MIDI too) and full OSC control.
+
+ Carla currently supports LADSPA (including LRDF), DSSI, LV2, and VST plugin formats, plus GIG, SF2 and SFZ file support.
+ It uses JACK as the default and preferred audio driver but also supports native drivers like ALSA, DirectSound or CoreAudio.
+
+ There are 3 types of engine processing: +
++ Note: The internal patchbay does not save/restore connections yet, so you'll want to run Carla under some kind of Session Management. LADISH level 1 and NSM are implemented. +
+ + +
+ By default Carla uses its own internal theme, a screenshot of it follows along with some plugins:
+ 
+ The user can keep the custom theme but use system colors, or simply disable the custom theme altogether.
+ The result may not be as nice though.
+
+ The 'Patchbay' uses the same canvas engine that Catarina, Catia and Claudia do:
+ 
+
+ 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.
+ This tab is not available in the Windows version.
+
+ The first time you run Carla you'll most likely want to scan for plugins.
+ 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.
+
+ Because Carla is a somewhat complex application, a single page is not enough to cover it entirely.
+ (We're currently writing the rest of the pages so be back soon!)
+
+ The following are the release notes for version 1.0.2: +
+
+ Carla is available in the KXStudio repositories and ArchLinux AUR (both with 'carla' package name).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux and Windows.
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+
+ Windows 32bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ Catarina is a Patchbay test app, created while the PatchCanvas module was being developed.
+ It allows the user to experiment with the patchbay, without using ALSA, JACK or LADISH.
+ You can save & load patchbay configurations too.
+
+ A screenshot follows:
+ 
+
+ The 'File' menu and 'Project' toolbar provides actions related to projects: the common new, open and save.
+ 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.
+ 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.
+
+ As with all the Cadence tools, you can hide the toolbar via 'Settings' menu, and also configure Catarina.
+ The configure dialog looks like this:
+ 
+
+ 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).
+ Fancy Eye-candy has 3 states:
+
+ (Note: Full eye-candy currently is EXPERIMENTAL, and will make Catarina crash at random times. The cause of the crashes are under investigation).
+
+ 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.
+ OpenGL is experimental within Qt4 itself, and will not work properly on all systems.
+ Anti-aliasing has 3 states:
+
+ Settings will be applied as soon as you press 'OK', no need to restart Catarina.
+
+ Catarina is available in the KXStudio repositories and ArchLinux AUR ('catarina' package in the KXStudio repositories, 'cadence' in AUR).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux and Windows (part of the Cadence bundle).
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+
+ Windows 32bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ Catia is a JACK Patchbay, with some neat features like A2J bridge support and JACK Transport.
+ It's supposed to be as simple as possible so it can work nicely on non-Linux platforms.
+
+ A screenshot follows:
+ 
+
+ Catia is available in the KXStudio repositories and ArchLinux AUR ('catia' package in the KXStudio repositories, 'cadence' in AUR).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux and Windows (part of the Cadence bundle).
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+
+ Windows 32bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ Claudia-Launcher is a multimedia application launcher with LADISH support.
+ It searches for installed packages (not binaries), and displays the respective content as a launcher.
+ The content is got through an hardcoded database, created and/or modified to suit the target distribution.
+
+ A screenshot follows:
+ 
+
+ Claudia-Launcher is available in the KXStudio repositories and ArchLinux AUR ('claudia' package in the KXStudio repositories, 'cadence' in AUR).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
+ Claudia is a LADISH frontend; it's just like Catia, but focused at session management through LADISH.
+ It has a bit more features than the official LADISH GUI, with a nice preview of the main canvas in the bottom-left.
+ It also implements the 'Claudia-Launcher' add-application style for LADISH.
+
+ A screenshot follows:
+ 
+
+ Claudia is available in the KXStudio repositories and ArchLinux AUR ('claudia' package in the KXStudio repositories, 'cadence' in AUR).
+
+
+ ArchLinux (AUR)
+
+
+ Debian/Ubuntu (via KXStudio repositories)
+
+ Pre-compiled binaries are available for Linux (part of the Cadence bundle).
+
+
+ Linux 32bit
+
+
+ Linux 64bit
+
+ The latest source code is hosted on github, together with bug reports, feature requests, etc.
+
+
+ Source code
+
+
+ Bug reports / Feature requests
+
The KXStudio Desktop theme uses QtCurve as the rendering engine, making it available on Qt3, KDE3, Qt4, KDE4 and Gtk2 applications.
+There is a Metacity and XFWM theme as well.
+The icon theme used is Oxygen.
+
Here's some screenshots showing off the theme on different Desktop Environments:
+
|
+
|
+
+
|
+
+
|
+
You can get the entire artwork in the Downloads section, just like any other application from us. +
+To properly apply this theme, you can follow these steps:
+
A XFWM decoration theme is available for XFCE. You might want to use 'Oxygen Mono Light|Dark' to get monochrome panel applets.
+Please note that Gtk3 is not supported at the moment.
+
+
Besides the theme, the "KXStudio Desktop" also consists of (resumed): +
+
+JACK integration
+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.
+For non-JACK aware apps, bridges are used.
+ PulseAudio works nicely with JACK, although it needs a bit medium/high buffer size in order to work properly.
+ ALSA has a plugin for JACK too, although it's not perfectly stable.
+ SDL-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.
+
+Audio Session management through LADISH
+There needs to be a tool to manage audio projects (and non-audio as well), and LADISH already provides this functionality.
+By integrating with LADISH, we can set-up custom JACK settings, apps and connections, and load it at any time, even when login in.
+
+One-app-to-rule them all (Cadence)
+Cadence is our own app that controls the whole audio system, using JACK and LADISH.
+This is pre-alpha software though, and it's not even released yet (although it's already present in the KXStudio repositories for testing).
+A full Cadence explanation/tutorial will be available once it reaches Alpha 1 (first public release)
+
+
There are plans to make our own Desktop Enviroment (including Window Manager), based on Twindy.
+A *Mock-up* can be seen here.
+There's nothing done for it yet, and it won't be so soon, as there is plenty of stuff to do first ;)
+
+ This page is meant for people that want to contribute to KXStudio. +
+
+ Please note that KXStudio has project pages in both SourceForge and Launchpad (you can check the respective links on the left).
+ SourceForge does the website, code and repository hosting, while Launchpad is used for managing bugs, questions/answers and the RSS news feed.
+ The Cadence tools don't use SourceForge or Launchpad, but are hosted on github instead at https://github.com/falkTX/Cadence.
+
+ If you're looking to report a bug in the Cadence tools, use the github "Issues" interface available here.
+ For KXStudio related bugs click here.
+
+
+ Regarding KXStudio development, we currently need: +
+
+ In any case, you should always check the KXStudio TODO List to find out what you can do.
+ (You don't need to know programming to help).
+
+ KXStudio future plans are discussed here. +
+
+ This page contains a list of things left to do for KXStudio.
+
+
+ Tasks for common people (not Team restricted): +
+
+ Work has already been done for this, but it's still far from finished.
+ The current theme uses the solidity-gtk3 engine.
+ It's available in the latest KXStudio Artwork release.
+
+ kxstudio-menu has been proven to work on Gnome2, KDE3, KDE4 and XFCE4.
+ It may not work on LXDE, needs testing (any LXDE users here?).
+
+ If you're looking for help regarding an Ubuntu feature, please search within the
+ Ubuntu Forums.
+ You can also use IRC, channel #kxstudio, server irc.freenode.net (or irc.freenode.com).
+
+ Please note that documentation for KXStudio is a work in progress, if you need some information not available here, you can try: +
+ + + +
+
+ Some useful topics:
+
+ KXStudio 12.04.3 Release +
+
+
+ KXStudio Distribution & Repositories
+
+
+ KXStudio Manual
+
+ (The manual is being written by Dan MacDonald with the assistance of Aaron Wolf, falkTX and the LinuxMusicians community). +
+ +
+ This section describes how to install a minimal Ubuntu system using a Net-Boot ISO.
+ After the base install is done, we'll proceed to upgrade Ubuntu to KXStudio.
+
+ There are some requirements you need to check before trying this:
+ 1 - Your system is connected to the internet via cable;
+ 2 - You've downloaded and burned a KXStudio Net-Boot ISO into a CD;
+
+ Make sure your PC is booting from CD drives (the F8 or F9 key during bios splash usually can change the boot media).
+ 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).
+
+ When you boot from the ISO, the first thing you'll see is a list of languages - pick yours.
+ Tip: Use the 'F3' key now to change the default keyboard language too.
+
+ Now just click 'Enter' to start the installation. +
+
+ 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.
+ You can browse through the interface using the keyboard. The mouse does nothing at this point.
+
+ This installation method is exactly the same in an Ubuntu or Debian net-boot ISO, and it's very similar to the "alternate" method.
+ Note that if you never used this kind of methods to install a Linux system before, you probably should not install KXStudio this way!
+ Please go with UbuntuStudio 12.04 as a base install, and upgrade to KXStudio afterwards.
+
+ Once you've installed the base system, it will automatically reboot. + You can remove the CD now. +
+ +
+ Login in the terminal with the user credentials you entered during the installation.
+ Note: You won't get any feedback while entering the password - this is normal (actually a security feature).
+
+ When logged in, run these commands to enable the KXStudio repositories:
+
+ sudo apt-get update
+
+ sudo apt-get install python-software-properties wget
+ sudo add-apt-repository ppa:kxstudio-team/kxstudio
+ sudo apt-get update
+ sudo apt-get install kxstudio-repos
+ sudo apt-get update
+
+ For this "final" step, you can follow the Upgrade From Ubuntu tutorial, since the steps are the same.
+ Just skip to the Step 2 - direct link
+
+ Of course, you won't have any GUI at this point, so you need to use the command-line methods. +
+ +
+ These are the release notes related to the KXStudio 12.04.1 Release, based on Ubuntu 12.04.1 LTS.
+ We recommend you to take a look at the Ubuntu's 12.04 release notes too,
+ here.
+ (Read the 'Kubuntu' notes if you use KDE, 'Xubuntu' for XFCE and so on).
+
+ 
+ 
+ 
+ 
+ 
setxkbmap pt (replace 'pt' by the relevant keyboard layout/language).
+ These are the release notes related to the KXStudio 12.04.3 Release, based on Ubuntu 12.04.3 LTS.
+ We recommend you to take a look at the Ubuntu's 12.04 release notes too,
+ here.
+ (Read the 'Kubuntu' notes if you use KDE, 'Xubuntu' for XFCE and so on).
+
setxkbmap pt (replace 'pt' by the relevant keyboard layout/language).+ +The Advanced Linux Sound Architecture is the primary sound system used by Linux. Even those who only plan to use JACK with the FFADO (FireWire) drivers should still have familiarity with ALSA. +
+ ++ +The main ALSA mixer included with KXStudio is called kmix. You can use kmix to adjust audio input and output levels, mute and unmute channels and change other non-FireWire audio device settings such as selecting between SPDIF and analog inputs if your device has such features. The kmix system tray icon looks like this: +
+ +
+
+
+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. +
+ +
+
+
+Here we see the main kmix mixer window. kmix displays the controls for each ALSA device on its own separate tab. In this screenshot the 'HDA Intel' onboard audio device is selected. +
+ ++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. +
+ ++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. +
+ ++Whilst there is a standard defined for USB audio devices, relatively few devices fully comply with it. What this means for ALSA and USB devices is that sometimes you will see no controls under kmix for some USB devices or controls may not function as expected. Such issues may be worked around by inserting an app such as Non mixer or jack_mixer between an audio source and the problematic output device until the issue is fixed within ALSA. +
+ ++ +Cadence is primarily used to control and monitor the various Linux sound systems, including ALSA, under KXStudio. The main Cadence window has a 'JACK bridges' section which contains two ALSA/JACK bridges - one for ALSA audio and one for MIDI. You will not hear audio produced by ALSA-only apps when JACK is running if the ALSA audio bridge is stopped. Likewise, you will be unable to access MIDI devices if the ALSA MIDI bridge isn't running when JACK is. +
+ ++ +As JACK increases in popularity, it is more widely supported. However, several apps are still ALSA-only. Such apps will have their audio channeled via the same ALSA to JACK bridge. These include: +
+ ++Adobe Flash Player (as used by Firefox and other browsers for sites such as YouTube) +
+ ++Many games and other various programs +
+ ++Some other apps have only partial JACK support. These work with JACK directly, have their own JACK connections, and function without the ALSA to JACK bridge, but their connections are not persistent. They will temporarily connect to JACK while playing but drop their connection as soon as playback is stopped. Examples of these apps are: +
+ ++Audacity +
+ ++SMPlayer +
+ ++VLC +
+ ++Hence, none of these offer the individual audio routing functionality or other features offered by fully JACK-native software. +
+ ++ +The following commands can be useful for troubleshooting ALSA issues in a terminal: + +
+alsamixer+ +
+ +The original ALSA mixer + +
+cat /proc/asound/cards+ +
+ +Displays attached ALSA devices + +
+cat ~/.asoundrc+ +
+ +Displays your ALSA configuration file + +
+sudo alsactl store 0+ +
+ +Saves the current settings for ALSA device 0 +
+ ++ +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. +
+ +
+
+
+ +This tells you the operating system, kernel version, and whether you are running a 32 or 64 bit OS. 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. +
+ ++ +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. Note: to enable this option in KXStudio 12.04.1, you must first install “indicator-cpufreq” but this will be included on install in 12.04.2. +
+ ++ +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 ISO as it includes a low latency kernel. The other check verifies that your user is included in the audio group. Being a member of the audio group is required for your user to run JACK in realtime mode for optimal performance. You can add your user to the audio group by running: + +
+sudo adduser <username> audio+ +
+ +Replace <username> with your KXStudio user name when you run that command in a terminal. You will then need to log out and back in or reboot before your user will be recognised as being in the audio group. +
+ ++ +Server Status tells you if the JACK server is running or not. You cannot run any JACK-dependant software unless the JACK server is started beforehand. +
+ ++Realtime 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. +
+ ++DSP Load is the current CPU load estimated by JACK. If it gets too high you may experience performance issues. +
+ ++Xruns For JACK to operate smoothly and without drop-outs it requires that its buffers (the memory used to transport audio) provide a continuous stream of data. Whenever this data fails to arrive in time to satisfy the requests of a JACK app it causes an xrun which is often accompanied by a disruption to the sound output. The key to success with JACK is to eliminate or avoid xruns. +
+ ++Buffer size is measured in frames per second. It determines the latency between the audio being received by JACK and being sent to the output device. The smaller the buffer the lower the latency and, as a result, the higher the accuracy when monitoring audio for multitrack recording. 1024 is the default and is usually a safe value but smaller buffer sizes have less latency, i.e. less delay between the input and output. Try different settings to see how low you can go when recording without getting xruns. The functioning of lower size buffers depends on the power of your CPU and the specifics of your audio device. The lowest buffer most devices can handle well is 64. +
+ ++Sample rate is the frequency JACK will run and record audio at. 44.1kHz is the CD audio standard, but 48kHz is more common to go with video or for other typical audio. Higher sample rates allow for higher quality but take more disk space. Even for professional purposes, 48kHz is usually fine as the default. +
+ ++Latency 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. +
+ ++ +Start Starts the JACK server, if its not running. This is the recommended way to start JACK. +
+ ++Stop stops the JACK server. It is wise to save your work in any open JACK apps before stopping JACK, just to be safe. +
+ ++Force restart should 'Start' fail to start JACK, it is worth trying 'Force restart' but you may lose the last changes made to the JACK settings. +
+ ++Configure opens the JACK settings window, which is covered in the next chapter. +
+ ++Switch Master tells JACK to apply any changes made in the JACK settings window. +
+ ++Auto-start JACK or LADISH at login 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. +
+ ++ +Cadences main window integrates the control of a few 'JACK bridges' -services which enable alternate Linux sound systems to run seemlessly atop JACK. +
+ ++The ALSA audio bridge enables one or more ALSA audio applications to access your JACK device when it is started. Most everybody will want to ensure this is kept running alongside JACK as it enables audio for non-JACK apps such as Firefox. If you have chosen for JACK to start at boot then the ALSA audio bridge also gets started automatically. +
+ ++The ALSA MIDI bridge needs to be running if you want to use any MIDI hardware. +
+ ++PulseAudio is not included by default with KXStudio, and so the PulseAudio bridge will not function without PulseAudio.. Most applications which use PA also use ALSA directly so there is then no need for PA or the bridge. If needed for some reason, you can use PA with JACK via the bridge if PulseAudio is installed first. + +
+ ++ +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. +
+ ++ +Download the KXStudio Live-DVD images from: +
+ ++http://kxstudio.sourceforge.net/Downloads#LiveDVD +
+ ++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. +
+ ++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. +
+ ++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. +
+ ++ +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. Full instructions are available for burning an iso file to a DVD under Windows, Mac, and GNU/Linux. Booting from a USB drive is faster than from DVD. Also, a USB drive can be set to save updates and work and function as a working system; but you won't experience the full speed and capacity of KXStudio until you install it to a hard drive. +
+ ++If using USB, you will need a FAT32 formatted USB drive with at least 2 GB free space. You can then use the freely available unetbootin under Windows, OSX or Linux to transfer the iso file and make it boot from your USB drive. Using Unetbootin is as simple as selecting the '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. +
+ ++ +Reboot your machine with the KXStudio DVD in the drive or with the unetbootin modified USB drive attached. In rare cases, your computer will automatically boot KXStudio. Typically, however, you will need to find out how to enter the boot menu on your machine or enter the BIOS or UEFI menu to change the boot order so that the DVD and/or USB drive takes higher boot priority than the hard drive. Commonly, pressing F12 right at start up will bring up the boot options; pressing F2 will bring up the full BIOS menu. In other cases, DELETE or ESCAPE are used. If none of these work, refer to the manual for your computer or search online for machine-specific instructions. +
+ ++If you boot the DVD, you will first be prompted to choose the language to use. When this occurs, you can either do nothing and wait 30 seconds before the default of English is chosen and booting continues or you can use the arrow keys and ENTER to choose an alternate language. Booting off the USB via unetbootin does not bring up the language selection menu directly; instead you may change language settings under 'System Settings'. + +
+ ++ +Listed below are recommended audio, video and productivity apps for GNU/Linux complete with a short description. +
+ +
+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.
+
+
+
+ +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. +
+ ++REMEMBER TO ALWAYS BACK UP all important files before you start modifying partitions or trying to install new operating systems! +
+ ++ +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 know if your machine is UEFI or not before you start installing. +
+ ++If you want to install KXStudio onto the same drive as an existing installation of Windows read this guide on how to resize your Windows drive. +
+ ++ +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. +
+ ++ +Those wishing to multi-boot Windows, OSX or other operating systems with KXStudio on a UEFI machine are recommended to obtain a copy of Linux Secure Remix 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. This tool may be included on future KXStudio DVD releases. +
+ ++The Boot-Repair process is documented here. If Boot-Repair doesn't cure your UEFI booting woes it would be worth trying rEFIt or gummiboot./ +
+ ++ +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. +
+ ++To customize your partitions, run “GParted” from the KXStudio live session before running the KXStudio installer. + +
++ +The KXStudio Live DVD is based upon Ubuntu 12.04 and uses the same installation tool so you can reference the official Ubuntu Install guide. 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. +
+ ++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. +
+ ++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. +
+ ++ +After installing and booting KXStudio for the first time, you will see the KXStudio Welcome screen. The design and options for this are being updated for the upcoming 12.04.2 release. This manual will include links or information to help guide your choices once the form of the welcome program is set. Until then you are safe to just accept its defaults if you are unsure what its options mean. +
+ ++ +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: + +
+sudo update-grub +sudo grub-install /dev/sda+ +
+ +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. +
+ ++SuperGrubDisk2 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. +
+ ++Another useful tool to ease GRUB2 configuration is GRUB Customizer. +
+ ++ +The KXStudio installer does not tweak the configuration of Solid State Drives for optimal performance. Follow this guide to optimize the performance of your SSD drives. + +
+ ++ +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: +
+ +
+
+
+ +The driver column to the left selects which JACK driver you wish to configure and use next time you start JACK with Cadence. Those using FireWire devices should use the FireWire driver but otherwise you should select ALSA for your JACK driver. +
+ ++The top 3 drop-down options within Cadence's ALSA 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 ALSA devices to handle Input and Output individually. This could be useful, for example, if you need a mic input but wanted to have your sound output via a USB audio device that doesn't have a mic input. In this case you could use your computers ALSA device, which likely does have a mic input, as a separate input device. If Duplex Mode is not selected then the top drop-down is used to select the ALSA device to use for both audio input and output. +
+ ++ +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. +
+ ++Sample Rate Due to the way latency is calculated, it is recommended you use 48000 or 96000Hz for the lowest latency. +
+ ++Buffer 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. +
+ ++Periods/Buffer The larger the period size, the higher the latency but the less chance of xruns. Experiment with using 2 or 3 periods/buffer. +
+ ++Extra Latency 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. +
+ ++ +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 cadence-logs from a terminal. +
+ ++ +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. +
+ ++ +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: +
+ ++RTIRQ_NAME_LIST=“firewire snd usb i8042” +
+ ++Here we see FireWire devices have priority over ALSA and USB devices because its mentioned first. If you are mainly running JACK on a USB device you may wish to make usb the first item in the list by editing that line in the rtirq config file with a command such as: + +
+kdesudo kate /etc/default/rtirq+ +
+ +Along with its Ubuntu base and the whole GNU/Linux world, KXStudio has its roots in the Free Software movement led by Richard Stallman and the GNU project. All of the custom KXStudio tools are FLOSS, as is the vast majority of other included software. +
+ ++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. +
+ ++ +KXStudio is based upon Ubuntu which includes select non-free software. The Ubuntu non-free software is listed in separate repositories marked as either “non-free”, “restricted”, or “multiverse”. See help.ubuntu.com/community/Repositories 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). +
+ ++The main non-free software that KXStudio includes from Ubuntu is Flash Player. Many websites still, unfortunately, depend upon Adobe Flash, so Flash Player provides the smoothest user experience. Thankfully, the FLOSS standards Webm and HTML5 are becoming increasingly popular, and there is a FLOSS Flash-replacement called GNASH. Hopefully there will be less reason for the non-free Flash Player in the future. +
+ ++Ubuntu also includes some non-free codecs for accessing proprietary file formats. +
+ ++Some hardware manufacturers, particularly among wireless cards and graphics accelerators, do not make FLOSS drivers for Linux but create proprietary non-free drivers. FLOSS 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 installing non-free video drivers. +
+ ++ +While all KXStudio PPA listings are otherwise strictly FLOSS, KXStudio includes non-free extras kept in a segregated repository. The packages are listed in Muon Package Manager By Origin under “KXStudio (Extra)”. In the software sources, the repository is “http://kxstudio.sourceforge.net/repo/ precise free non-free”. +
+ ++The KXStudio non-free repository includes the following: + +
++ +Specific non-free software can be manually uninstalled, see the instructions for package management. Aside from the items listed above, another way to quickly identify a good portion of installed non-free software is to install the program vrms, 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. +
+ ++To remove non-free software from the package listings, choose “Configure Software Sources” under “Settings” in Muon Package Manager. There, you can uncheck the Proprietary drivers and multiverse (copyright or legally problematic) listings. On the “Other Software” tab, you can remove the Medibuntu and kxstudio.sourceforge.net repositories. +
+ ++If you want to use strictly 100% Free Software, including even the strictly-FLOSS Linux-libre kernel, consider Trisquel, which is based on Ubuntu yet is certified by the Free Software Foundation. You can then add the main KXStudio-Team PPAs following the same instructions as for other Ubuntu-based systems. Although this should work, it is not officially supported at this time. +
+ ++There is also a long-term plan to potentially move the KXStudio repositories to Debian, which is more strictly FLOSS than Ubuntu (although still not FSF-approved because it provides a mechanism for users to install non-free software). + +
+ ++ +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. +
+ ++ +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. +
+ ++ +As a distribution or OS, KXStudio is largely based upon Ubuntu which is one of the most popular variants of GNU/Linux. Ubuntu has a parent company called Canonical which has employees working on Ubuntu as well as the help of its large community of users and developers plus an increasing number of third party commercial software companies offering software or support for Ubuntu. Being based upon Ubuntu, KXStudio is compatible with Ubuntu software and resources. +
+ ++Seeing a need for better audio/video integration in the system, a talented young Portuguese developer known online as falkTX decided to improve the management and ease of use of various audio sub-systems and related software. To reach that goal, he created the KXStudio project which is closely related to his Cadence suite of tools, the Carla plugin host, and the DISTRHO audio plugins. falkTX puts an incredible amount of time and effort into creating and supporting these and has also assisted in improving numerous other FLOSS projects. If you appreciate his ongoing hard work he would be grateful for any contributions you can make via http://kxstudio.sourceforge.net/Donations . Thank you! +
+ ++ +If you are familiar with MS 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 MS 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. +
+ ++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 Useful Links section of this manual for various Linux hardware compatibility reference sites. +
+ ++ +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: +
+ ++You will need a loopback cable capable of connecting your audio device's physical input to its physical output. +
+ ++1 - Connect your (mic) input to your (headphone) output with the loopback cable +
+ ++2 - Start JACK with known good settings +
+ ++3 - Open a terminal and run jack_iodelay. It will print 'Signal below threshold…' until we make the JACK connections +
+ ++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 +
+ ++5 - With both physical and JACK connections made, jack_iodelay should print output such as 'use X for the backend arguments -I and -O' +
+ ++6 - In the terminal, use ctrl-C to stop jack_iodelay +
+ ++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 +
+ ++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. +
+ ++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. +
+ ++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. +
+ ++ +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. +
+ ++ +Many pop-up ads and popular web sites make use of Adobe Flash. If you have any browser tabs open, it only takes one to be using a little bit of Flash to cause a big loss of CPU, lower latency and more xruns. You should try to avoid running unnecessary, CPU intensive programs when recording. +
+ ++ +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. +
+ ++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. +
+ ++ +Open a terminal and run: + +
+cat /proc/interrupts+ +
+ +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 see this guide to fixing IRQ conflicts. + +
+ ++ +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. +
+ ++ +ALSA, the Advanced Linux Sound Architecture, is a collection of drivers and libraries that provide Linux with audio and MIDI support for onboard, PCI, and USB audio hardware. ALSA doesn't support FireWire audio devices — that requires FFADO and JACK (see below). +
+ ++ALSA alone is insufficient for most AV production tasks because only one application can access an ALSA device at any one time. JACK and Pulseaudio were created mainly to overcome this restriction although they target different use cases. KXStudio includes an ALSA/JACK bridge program called “snd-aloop daemon” which enables the user to run ALSA-only apps alongside JACK and other JACK-native software. This bridge is turned on by default when JACK is started - see the Cadence instructions for more information. +
+ ++ +The JACK Audio Connection Kit is a program (jackd aka the JACK server) and a protocol/API 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. +
+ ++ +FFADO provides Free FireWire Audio Drivers (the “O” is for .Org). Unlike ALSA, FFADO depends upon JACK and does not work independently. Hence, when you select a FireWire audio device for use by JACK under the Cadence driver configuration, you are using the FFADO drivers. +
+ ++ +PulseAudio (PA) is a sound server which, like JACK, runs on top of ALSA to provide functions such as allowing more than one application to use an ALSA device simultaneously. Pulse is targetted at regular desktop and mobile users rather than low-latency audio production. Cadence includes a PulseAudio/JACK bridge enabling you to run PulseAudio apps under JACK, but there are very few apps which support PA without supporting JACK or ALSA. KXStudio does not include PulseAudio as part of the default installation, but it is easily installed with the package manager if required. + +
+ ++ +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. +
+ ++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. +
+ ++In KXStudio 12.04.2, the main package manager is called Muon. Muon is the easiest way to manage your software under KXStudio. KXStudio previously used the Synaptic package manager instead but these instructions largely apply to that as well. +
+ ++ +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. +
+ ++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. +
+ ++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. +
+ ++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. +
+ ++ +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. +
+ ++ +Start Muon Package Manager, then type either the name of the program you want or search using a descriptive term. +
+ ++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'. +
+ ++If the chosen app requires additional packages be installed for it to funtion, then you will be asked to confirm the installation of the required additional packages. These extra packages are referred to as dependencies, 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. +
+ ++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. +
+ ++ +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 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. +
+ ++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 Ubuntu 12.04 (codenamed Precise) so it is compatible with packages made for that distribution. Make sure you get the 32- or 64-bit package as appropriate. The main Cadence window tells you if you are running a 32 bit (aka i386 or i686) or 64 bit (amd64) system. +
+ ++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. +
+ ++ +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. +
+ ++ +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. +
+ ++ +The KXStudio repositories are themselves PPA's. In some cases, you may want to add new PPA's to your system. +
+ ++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. +
+ ++If a PPA is available, it will be listed either on a software's website or their Launchpad.net page. 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 +
+ ++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. +
+ ++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. +
+ ++ +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 + +
+sudo apt-get install -f +sudo dpkg --configure -a+ +
+ +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. +
+ ++KXStudio includes an app called Claudia which uses the LADISH JACK session management standard 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). +
+ ++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 ALSA 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 ALSA bridges, load qtractor and connect alsa2jack to its inputs so its ready to record from Firefox at boot. +
+ ++ +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. +
+ ++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. +
+ ++ +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 ALSA audio bridge to be running. When you have the ALSA audio bridge running you will see an extra two items (JACK clients) in Claudia'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. +
+ ++ +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. +
+ ++ +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 ALSA 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: +
+ +
+
+
+ +Cadence can automatically load a Claudia studio at system launch if you like. This should probably be avoided if you are using a system in which your studio's audio device is not always connected. +
+ ++To set a studio to auto-load, 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. 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. +
+ ++ +For more info on the KXStudio applications such as Cadence, Claudia and Catia +
+ + + ++ +To check to see if your sound device is supported by GNU/Linux, check the ALSA SoundCard Matrix +
+ ++http://www.alsa-project.org/main/index.php/Matrix:Main +
+ ++If you have a FireWire audio device you will want to check the status of your device in the FFADO Device support database +
+ ++http://www.ffado.org/?q=devicesupport/list +
+ ++Another good resource for GNU/Linux audio hardware compatibility is the linuxaudio.org Current Audio Gear page +
+ ++http://wiki.linuxaudio.org/wiki/current_audio_gear +
+ ++To check for the compatibility of your printer with the GNU/Linux printing system, CUPS, check the OpenPrinting database +
+ + + ++ +The Ubuntu package archive search +
+ ++http://packages.ubuntu.com/ +
+ ++The linuxaudio.org wiki has a comprehensive list of all GNU/Linux audio and sound software +
+ ++http://wiki.linuxaudio.org/apps/start +
+ ++Libre Graphics World provides news and other resources relating to free graphics software +
+ ++http://libregraphicsworld.org/ +
+ ++Freecode maintains the Web's largest index of GNU/Linux software +
+ + + ++The Wine Application Database (AppDB) details the compatibility of Windows programs with Wine +
+ + + ++ +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 +
+ ++https://help.ubuntu.com/community/UsingTheTerminal +
+ ++KXStudio uses the KDE Desktop Environment by default. Here is an introduction to the KDE 4 Plasma desktop +
+ ++http://userbase.kde.org/Plasma +
+ ++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 +
+ + + ++Those who prefer the more lightweight DAW qtractor will be happy to hear it has one of the best free manuals available for a GNU/Linux app +
+ ++http://downloads.sourceforge.net/qtractor/qtractor-0.5.x-user-manual.pdf +
+ ++ +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. +
+ ++ +If you get stuck, the first place to search for a solution is on the KXStudio forum +
+ ++http://linuxmusicians.com/viewforum.php?f=47 +
+ ++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 +
+ + + ++The LinuxMusicians wiki contains all sorts of useful info for Linux audio users, including this manual +
+ + + ++ +If you can't find an answer to your question on the fora or with your favourite search engine, IRC is going to be your best hope of getting help quickly. +
+ ++KXStudio includes the Konversation KDE IRC client which you can use to connect to the following channels on irc.freenode.net +
+ ++#kxstudio is the official IRC support channel for KXStudio +
+ ++#opensourcemusicians is the IRC channel of the open source musicians podcast +
+ ++#ardour has its own official IRC support channel on freenode.net as do many other popular open source projects +
+ ++#kde is good for general issues with using the K Desktop +
+ ++#ubuntu is the support channel for general Ubuntu system issues +
+ ++ +The majority of modern day PC hardware uses display technology from either Nvidia, ATI/AMD, or Intel. +
+ ++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. +
+ ++ +If you're unsure what vendor or model video hardware you have installed in your machine, open a terminal (such as Konsole) and type: + +
+lspci+ +
+ +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. +
+ ++ +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. +
+ ++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. +
+ ++ +To enable the screen brightness control keys and disable the NVIDIA boot logo on my NVIDIA-using laptop using the non-free nvidia driver I had to create a file located at /usr/share/X11/xorg.conf.d/10-nvidia-brightness.conf containing: + +
+Section "Device" + Identifier "Device0" + Driver "nvidia" + VendorName "NVIDIA Corporation" + BoardName "GeForce 8600M" + Option "RegistryDwords" "EnableBrightnessControl=1" + Option "NoLogo" "true" +EndSection+ +
+ +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 FLOSS ones, see the community wiki: wiki.cchtml.com + +
+ ++ +KXStudio includes a program called Wine (Wine Is Not an Emulator) which allows most MS Windows software to run under GNU/Linux. It is FLOSS and does not require a copy of Windows to run it. While a number of Windows applications will not run at all under Wine, there is the odd app or game that runs better under Wine than real Windows! In most cases though, MS Windows apps run slower under Wine than under a genuine Windows install. Overall, it is recommended to run native GNU/Linux software instead of using Windows software under Wine, but the option of Wine allows flexibility if no suitable, Linux-native alternative software is available at the moment. +
+ ++ +Audio Stream Input/Output (ASIO) is the most common low-latency sound card driver protocol for MS 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. +
+ ++ +WineASIO provides a few options that can be configured within Cadence. These options are: +
++ +(Cadence WineASIO settings screenshot: http://kxstudio.sourceforge.net/screenshots/cadence4.png) +
+ ++ +If you ran KXStudio Welcome Setup before then you should already have the wineasio.dll library registered, otherwise or if you messed up your Wine configuration you should run: + +
+regsvr32 wineasio.dll+ +
+ +If you're running a 64-bit OS and you want to run 64-bit Windows software under wine, run the following too: + +
+wine64 regsvr32 wineasio.dll+ +
+ +You should only need to issue these commands once, if at all, and there is no harm in re-running them. +
+ ++ +KXStudio includes the MS 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-FLOSS-but-nonetheless-user-friendly licensing and its official support for running the Windows version under Wine. +
+ ++ This section describes all the meta-packages available in the KXStudio-Team Ubuntu repositories, splitted by type. +
+ +
+ The main meta-packages will simply install Audio, Graphic or Video applications.
+ The Audio meta-package is also split into plugin categories, for anyone that wants more plugins, but not actually more applications.
+ It's not like your KXStudio system will get slower with a bit more applications though...
+
+ The main meta-packages are: +
+
+ Some notes:
+ 'audio' recommends 'audio-plugins', and 'audio-plugins' depends on all it's sub-packages.
+ With the exception of KXStudio 12.04, 'graphics' recommends 'ubuntustudio-font-meta', which will install a nice collection of fonts.
+ On KXStudio 12.04, you have to install 'ubuntustudio-font-meta' manually if you want that font collection.
+
+ The extra meta-packages are: +
+
+ The 'codecs' package is self-explanatory, it will install a collection of codecs for gstreamer, sox and xine.
+
+ The 'non-free' will install some good but close-source software, like Renoise, energyXT, and Pianoteq.
+ These applications come as demos, see Documentation:Ubuntu:RegisterCommercial to activate them if you have a license.
+
+ The 'restricted-extras' is simply a combination of '[k|x]ubuntu-restricted-extras', and some other minor "restricted" stuff.
+ (In this case, "restricted" means that it can't be installed in Ubuntu by default, but you're safe to do it afterwards).
+ This package recommends 'kxstudio-meta-codecs'.
+
+ This section describes how to activate the non-free software available in KXStudio.
+
+
+ All Loomer plugins work the same way.
+ Just open the respective plugin GUI you have the license for, click the "Options" button at the top and select "Enter Licence Key...".
+ Fill in your license details and you're done ;)
+
+
+ Renoise registration is a bit unusual, but fairly easy.
+ 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).
+ Unpack it, and copy the 'renoise' binary inside into '/usr/bin/'. The next time you start renoise, it will be registered to your account.
+ Warning: 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.
+
+ This section describes how to upgrade from a regular Ubuntu install (or variants), to a cool and fresh KXStudio Desktop. +
+
+ This method will work in all supported Ubuntu versions since Lucid (10.04, 11.10, 12.04 and 12.10).
+ The recommended version to use right now is 12.04.
+
+ KXStudio officially supports KDE4 and partially XFCE (on 12.04/12.10, KXStudio will use UbuntuStudio desktop as base as it uses XFCE).
+ 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.
+ Create a new topic in the forums if you want support for other DEs.
+
+ Open up the 'Software Sources' (usually in the System menu), and on the 3rd party separator, add this code:
+ ppa:kxstudio-team/kxstudio
+ Alternatively, you can run this command, which has the same effect:
+
+ sudo add-apt-repository ppa:kxstudio-team/kxstudio
+
+
+ Next, reload the sources (method depends on the current application), and install the package 'kxstudio-repos'. Then reload the sources again.
+ You can do the same thing in the command-line with:
+
+ sudo apt-get update
+
+ sudo apt-get install kxstudio-repos
+ sudo apt-get update
+
+ 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. +
+ ++ 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!). +
+
+ Simply use whatever tool your Desktop Environment provides (Ubuntu Software Center, Synaptic, Update Manager, KPackageKit, Muon, etc).
+ 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:
+
+ sudo apt-get dist-upgrade
+
+ 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".
+
+ This step will take some time. Some minor questions may appear while the upgrade takes place. +
+ +
+ After the upgrade, it's time to install the main KXStudio packages.
+ Just like you did to install the 'kxstudio-repos' package, now install:
+
+ For KDE4 -> 'kxstudio-desktop-kde4'
+ For XFCE -> 'kxstudio-desktop-xfce'
+ For other systems install 'kxstudio-desktop-base' and the ubuntu related package, like 'lubuntu-desktop' for LXDE
+
+ This step if almost optional. Here we install the basic software for Audio, Graphics and Video.
+ Just like before, it's time to install some new meta-packages. They are available as listed here (following a tree view of dependencies):
+
+ Install the meta-packages you want just like before (ie, search for the package and click to install, or use in command-line: sudo apt-get install <package-name>)
+ See Documentation:Ubuntu:Meta-Packages for a description of these meta-packages.
+
+ Note - meta-all recommends restricted extras, and audio recommends audio-plugins. +
+ +
+ This step is optional, and mostly useful for audio production only.
+ Installing a kernel in KXStudio couldn't be easier - just install one of these packages:
+
+ The realtime kernels are only available for 10.04 and 12.04.
+ Ubuntu 10.04 uses a 2.6.33 RT kernel and 12.04 uses a 3.2.0 one.
+
+ After all this, it's time to reboot.
+ The next time you login, you'll see the KXStudio Welcome Screen to help you update your settings (and maybe the theme too).
+ You should also run 'cadence' and change your JACK settings to your preference.
+ Finally, just re-login again after updating the settings.
+
+ Of course, now it's time to enjoy! +
+ +
+ KXStudio is and always be a free and open-source project to everyone.
+ Donations will help ensure that developers have the needed enthusiasm and motivation to keep working hard on the project.
+ Just because we're open-source doesn't mean we're allergic to money. ;)
+
+ Currently the KXStudio project accepts donations via Flattr or PayPal.
+ You can do a one-time donation or subscribe monthly.
+ In either case, we thank you in advance for any donation you make!
+
+
| + |
+
+ 
+ | + + | + + |
+ You are now downloading the file
+ If the download doesn't start automatically, click
+ here.
+
+ Thank you for your interest on KXStudio and/or its software. Please consider a donation while the download takes place.
+ Donations will help ensure that developers have the needed enthusiasm and motivation to keep working hard on the project.
+ Just because we're open-source doesn't mean we're allergic to money. ;)
+
+ Currently the KXStudio project accepts donations via Flattr or PayPal.
+ You can do a one-time donation or subscribe monthly.
+ In either case, we thank you in advance for any donation you make!
+
+
| + |
+
+
+ | + + | + + |
+ Invalid download Id. +
+ + + +
+ The KXStudio artwork, which includes:
+ - KDE4 color scheme
+ - KDM theme
+ - KSplash theme
+ - Plymouth theme
+ - QtCurve config
+ - Gtk2/Qt3/Qt4 theme (using qtcurve engine)
+ - Gtk3 theme (using solidity engine, incomplete)
+ - Metacity theme
+ - XFWM4 theme
+ - Wallpapers
+
+ By using QtCurve, our theme can perfectly match Gtk2, Qt3, KDE3, Qt4 and KDE4 applications.
+ See the KXStudio Artwork section for screenshots of various Desktop Environments using the KXStudio theme.
+
+ Downloads:
+
+ 
KXStudio Artwork (version 2012-12-22)
+
+ Software developed by the KXStudio Team, pre-compiled and ready to run.
+
+ Linux Downloads:
+
+ 
Cadence (32bit, version 0.8.1)
+
+ Cadence (64bit, version 0.8.1)
+
+ 
Carla (32bit, version 1.1.0)
+
+ Carla (64bit, version 1.1.0)
+
+ 
FeSTige (32bit, version 1.0.2)
+
+ Windows Downloads:
+
+ Cadence (32bit, version 0.8.1)
+
+ Carla (32bit, version 1.1.0)
+
+ Software developed by the KXStudio Team, released as source tarball so that distros other than Ubuntu (or advanced users) can pick it up.
+ If you're running an Ubuntu based system, please use the KXStudio Repositories instead.
+
+ Downloads:
+
+ Cadence (version 0.8.1)
+
+ Carla (version 1.1.0)
+
+ FeSTige (version 1.0.2)
+
+ 
Klaudia (version 1.0.2)
+
+ This is an Ubuntu 12.04.3 LTS based Live-DVD, used to test-drive KXStudio and/or install it to your HDD.
+ It contains a snapshot of the KXStudio features as of Oct 17, 2013 or 17/10/2013. It uses KDE4 as Desktop Environment.
+
+ Downloads:
+
+
+ 
KXStudio 12.04.3 Live-DVD - 32bit
+ md5sum: 2e937f1249e6608369f9d17401b16887
+ size: 1.8 Gb
+
+
+ KXStudio 12.04.3 Live-DVD - 64bit
+ md5sum: ecd0b53bfaddfdf96454c1840f05a90b
+ size: 1.9 Gb
+
+ *Please* make sure to read the Release Notes before using this DVD.
+ You need to burn the ISO file into a DVD to make it usable, more details here.
+
+ You can access all the KXStudio downloads using the KXStudio SourceForge project page:
+ http://sourceforge.net/projects/kxstudio/files/
+
THIS IS A FAKE PAGE, KXSTUDIO NEWS USES A DYNAMIC MODULE NOW
+ +
+
+ > Carla Plugin Host 1.0.0 released!
+ On 2013-07-02 by falkTX
+
+ After more than 2 years in development, here it is - the first stable release of Carla is now available!
+ 
+
+ Carla Plugin Host, or just Carla, is an audio plugin host, with support for many audio drivers and plugin formats.
+ It has some nice features like automation of parameters via MIDI CC and full OSC control.
+
+ Carla currently supports LADSPA (including LRDF), DSSI, LV2, and VST plugin formats, plus GIG, SF2 and SFZ file support.
+ It uses JACK as the default and preferred audio driver but also supports native drivers like ALSA, DirectSound or CoreAudio.
+
+ We currently release source code plus Windows and Linux binaries (focus goes into the Linux version).
+ Downloads available at the usual place, KXStudio Downloads.
+
+ For more information about Carla check its own application page here.
+ We'll be updating that page in the next few days, with some tutorials and workflow videos as well, so stay tuned!
+
+ You can follow the release discussion over at LinuxMusicians forums.
+ If you find this application useful and/or want to help further development, please consider a donation.
+
+ > KXStudio 12.04.1 released!
+ On 2013-01-05 by falkTX
+
+ After much hard work, a new release of KXStudio is ready!
+ The previous ISO images were getting old, and since Cadence (and KXStudio in general) is now much more stable, it was time for an update.
+ Existing KXStudio users already have 90% of the changes and fixes as KXStudio uses the repositories for everything.
+ Still, this is a big milestone for the project. It's a step towards perfection.
+
+ Here's a quick list of changes since the previous 12.04 release. +
+
+ The DVD works properly now (no need to re-login to apply settings anymore) and also has an option to boot to RAM (requires at least 3Gb to work).
+ You can download the new ISOs at the KXStudio website, http://kxstudio.sourceforge.net/Downloads.
+
+
+ This release is dedicated to Hatsuke Miku, a [virtual] Vocaloid singer that recently has seen original artwork released under a Creative Commons license.
+ We believe that actions like this one (and others in 2012) indicate that the world embraces open-source culture more and more, every day.
+ You can find more about Miku
+ here,
+ and the its CC artwork
+ here.
+
+
+ We hope you enjoy KXStudio and the updated Cadence.
+ Soon enough the website will have full documentation for it and other subjects, so stay tuned!
+
+ > Call for Testing - Cadence pre-Beta
+ On 2012-09-17 by falkTX
+
+ Hello everybody!
+ We're almost in the Beta1 release of Cadence!
+
+ For those of you who don't know, Cadence is what KXStudio uses to manage the entire audio ecosystem.
+ 'Cadence' is by itself the main app of a series of tools (call it the "Cadence tools").
+ There's 'Catia', a simple JACK patchbay; 'Claudia' is a ladish frontend, very similar to Catia (and gladish); 'Carla' is the plugin host.
+ Then there's the small tools - JackMeter, JackSettings, Logs, Render and XY-Controller (their names give away their funtionality).
+
+ Cadence and its tools are currently being documented, and pages will appear here: (incomplete)
+ http://kxstudio.sourceforge.net/Applications
+ (There's a topic in the KXStudio forums discussing the documentation here).
+
+ If you're running KXStudio now, you either have updates or have recently updated Cadence and sub-packages.
+ I'll be pushing the latest Cadence code to the KXStudio repositories frequently in the next days while the testing happens.
+ ArchLinux users can use this AUR package:
+ https://aur.archlinux.org/packages.php?ID=50747
+ You can checkout what's going on in the Cadence commits page:
+ https://github.com/falkTX/Cadence/commits/master
+
+ Not everything is fully ready right now, here's a list of things that will still be done before the Beta1 release:
+ - Cadence audio-bridges, currently disabled
+ - Carla Windows plugin-bridge support (Linux 32/64bit bridges are already in place though). Note that this will remain an experimental feature even for this release.
+ - Carla-Control is unfinished, the GUI will do nothing useful right now.
+ - Catia ALSA-MIDI support is currently disabled, but will still not be activated for this release.
+
+
+ So, what needs testing?
+ Pretty much everything. :D
+ Run the apps, click on random stuff and try to make them crash. When that happens, or if notice something weird, please report the bug.
+ I've done my best to make the tools as stable + crash-free as possible, but we can never be too sure about these things.
+
+ You can report bugs directly in the official bug page at
+ https://github.com/falkTX/Cadence/issues.
+ (Reporting a bug in that page allows you to receive notifications whenever something is done related to it).
+
+
+ Thanks in advance to everyone that decides to help!
+ If you love these tools and they are useful to you, please consider making donation by following this link:
+ https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PDGZL8PKSNHYW.
+
+ > KXStudio 12.04 is out!
+ On 2011-12-21 by falkTX
+
+ Hey there everyone, it's that time again!
+ KXStudio is now ready for the masses, now using Ubuntu 12.04 as the base.
+
KDE4 remains the officially supported Desktop, with XFCE on 2nd place.
+ For this release I re-introduced the ISOs, although only 32bit for now. So now installing KXStudio can take 3 forms: Live-DVD, Ubuntu upgrade or NetBoot.
+ The Live-DVD uses KDE4, if you want XFCE instead please install UbuntuStudio first then follow the upgrade instructions as detailed here.
+
The Cadence tools are currently being ported to python3 in a new repo - https://github.com/falkTX/Cadence.
+ Catarina, Catia, Claudia and the minor tools are almost beta state right now. Carla and Claudia-Launcher are still in the works (but already very functional), and the real 'Cadence' app is yet to be ported.
+ These tools are already available on KXStudio in their latest git state, and will be released as beta for the while world very soon.
+
The DISTRHO plugin suite is now near completion and it's targeted for a new release this weekend.
+ The entire collection is already available in the KXStudio repos but yet part of the meta-packages (will be added shortly after the official release).
+ Generic linux binaries will be made available for non-KXStudio users as before.
+
+ Note: Since the KXStudio website has been internally reworked (removed mediawiki, much simpler PHP code now), the old news have been removed.
+
+
+ This section lists the audio plugins made by the KXStudio Team.
+ You might also want to check:
+
+ DISTRHO provides cross-platform plugins and Linux ports, including HighLife and TAL NoiseMaker.
+ The official website for DISTRHO is http://distrho.sourceforge.net/, and its respective forums are located
+ here.
+
+ NOTE: This is the project KXStudio uses to release original and Linux-ported audio plugins.
+ The split between projects allow us to make plugins non-dependent on KXStudio, but they are still made by the same team.
+
Calf Plugins
+ This is a fork of the latest development code of the Calf plugin suite, originally available at http://repo.or.cz/w/calf.git/.
+
+ This fork was made to re-add purposefully removed features by Calf developers, which includes LADSPA, DSSI and LV2 External-UI support.
+ Additionally, LRDF typos were corrected and all DSSI GUIs work now.
+
+ The new source code is available here. +
+ ++ This is a fork of dssi-vst, initially based on "k_amlie"'s code updates (to make it more RT friendly), with additional fixes from falkTX which includes: +
++ The source code is available here. + There's a specific dssi-vst topic in the KXStudio forums here. +
+ +
+ The KXStudio project has a few LV2 extensions of its own, adding missing functionality into the LV2 stack.
+ These are:
+
+ The KXStudio repositories support all Debian versions since Wheezy and Ubuntu 12.04 or above.
+ They should work on all Debian-based distributions and variants, but the way to enable them will differ.
+ After the repositories are enabled and the system updated, we recommend you to install the "kxstudio-default-settings" package.
+
+ You might also want to check: +
+ ++ Below is information on how to enable the repositories. +
+ Debian
+ Debian users can enable our repositories by installing this deb file:
+ kxstudio-repos.deb.
+ If you're running Debian Wheezy, consider installing the backports repo package as well:
+ kxstudio-repos-backports.deb.
+ (*only* for wheezy)
+
Ubuntu
+ Ubuntu users can also install deb files for the repositories, but different files are needed for each version.
+ As such, we recommend you to enable the repositories using the command-line instead. Just follow these steps:
+
+# Install needed tools +sudo apt-get install software-properties-common wget+ +
+# Enable KXStudio repo +sudo /usr/bin/add-apt-repository -y ppa:kxstudio-debian/kxstudio
+# Update software sources +sudo apt-get update
+# Install kxstudio-repos +sudo apt-get install kxstudio-repos
+# Update software sources again +sudo apt-get update +
+ If you're running Linux Mint Olivia (based on Ubuntu 12.04), we need to correct for a bug in Mint's code. Run this after enabling the repos: +
++# Fix add-apt-repository olivia vs precise mixup +sudo sed -i "s/olivia/precise/" /etc/apt/sources.list.d/kxstudio*.list+ +
+# Update software sources yet again +sudo apt-get update +
Others
+ Users on other linux distributions should enable the repositories that best match their distro.
+ Remember that KXStudio offers repositories only for Debian and its based systems.
+
+ This section lists the applications available in the repositories.
+ Click on the yellow application name to install its respective package.
+ You might also want to check:
+
| + + |
+
+ Cadence (JACK Toolbox) |
| + + |
+
+ Catia (Patchbay) |
| + + |
+
+ Claudia (Session Manager) |
| + + |
+
+ Renoise (Tracker, non-free) |
| + + |
+
+ SunVox (Tracker, non-free) |
+ This section lists the audio plugins available in the repositories.
+ Click on the green plugin name to install its respective package.
+ You might also want to check:
+
+ CAPS (LADSPA)
+ The C* Audio Plugin Suite (CAPS) comprises a range of classic sound effects and a few more basic audio DSP units, signal and noise generators.
+ The suite's aim is to provide impeccable sound quality, computational efficiency and no perceptible latency.
+ Homepage and Documentation: http://quitte.de/dsp/caps.html
+
+ REV-Plugins (LADSPA)
+ Reverb LADSPA plugins.
+ Includes a stereo reverb plugin based on the well-known greverb, and LADSPA versions of zita-rev1 in resp. stereo and first order Ambisonic mode.
+ Homepage: http://kokkinizita.linuxaudio.org/linuxaudio/index.html
+
+ KXStudio is a collection of applications and plugins for professional audio production.
+ KXStudio provides Debian and Ubuntu compatible repositories and its own Linux Distribution currently based on Ubuntu 12.04.3 LTS.
+
+ The KXStudio project is divided into 3 main sections: +
+ +|
+
|
+
+ Applications |
|
+
|
+
+ Plugins |
|
+
|
+
+ Repositories |
+ If you want to help development, a donation, even small, is very welcome.
+ Check the Donations section to know how you can make one.
+
+ 
+ 
+ 
+ 
+ 
