From f615b71e1afa139b5690f21610da77be228a079f Mon Sep 17 00:00:00 2001 From: falkTX Date: Sun, 25 Sep 2016 16:51:59 +0200 Subject: [PATCH] Update manual pages --- Documentation:Manual:alsa_and_kxstudio.php | 21 ++----- Documentation:Manual:cadence_introduction.php | 28 ++++----- ...anual:downloading_and_booting_kxstudio.php | 19 ++++--- ...n:Manual:included_and_recommended_apps.php | 15 ++++- Documentation:Manual:installing_kxstudio.php | 34 +++++------ Documentation:Manual:jack_configuration.php | 9 +-- ...tion:Manual:kxstudio_and_free_software.php | 27 ++++----- ...mentation:Manual:kxstudio_introduction.php | 10 +--- Documentation:Manual:latency.php | 22 +++---- Documentation:Manual:linux_audio_overview.php | 8 +-- Documentation:Manual:package_management.php | 24 +++----- ...mentation:Manual:simple_claudia_studio.php | 12 +--- ...n:Manual:useful_links_and_getting_help.php | 31 ++++------ Documentation:Manual:video_drivers.php | 43 ++++++++++---- Documentation:Manual:wineasio_and_reaper.php | 57 +++++++++++++------ 15 files changed, 177 insertions(+), 183 deletions(-) diff --git a/Documentation:Manual:alsa_and_kxstudio.php b/Documentation:Manual:alsa_and_kxstudio.php index d3dabb4..43e78fe 100644 --- a/Documentation:Manual:alsa_and_kxstudio.php +++ b/Documentation:Manual:alsa_and_kxstudio.php @@ -9,7 +9,6 @@ include_once("includes/header.php");

- 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.

@@ -19,12 +18,11 @@ The Advanced Linux Sound Architecture is the primary sound system used by Linux.

- 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:

-The kmix icon +The kmix icon

@@ -44,7 +42,7 @@ You will notice that each fader has a small speaker icon just below it. When the

-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. +In the bottom right corner of the mixer window there is a tool icon. This icon allows you to configure which channels are available to control for the currently selected kmix device tab. You may find that some controls you need are missing at first, so you may add them via this Configure Channels window. A common example of when you might need to use the kmix Configure Channels window is if you are using any SPDIF (optical) ports, which are referred to as IEC958 devices under GNU/Linux, as such controls are often not displayed by default.

@@ -57,7 +55,6 @@ Whilst there is a standard defined for USB audio devices, relatively few devices

- 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.

@@ -67,7 +64,6 @@ Cadence is primarily used to control and monitor the various Linux sound systems

- 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:

@@ -75,6 +71,10 @@ As JACK increases in popularity, it is more widely supported. However, several a Adobe Flash Player (as used by Firefox and other browsers for sites such as YouTube)

+

+Skype If you don't require webcam or video support then it is recommended you use Mumble instead of Skype for VOIP. Although Mumble doesn't yet officially support JACK, there is a build of Mumble with JACK support available from the KXStudio repositories. However, if you need to use Skype it works fine provided the ALSA audio bridge is running. +

+

Many games and other various programs

@@ -105,35 +105,26 @@ Hence, none of these offer the individual audio routing functionality or other f

- 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

diff --git a/Documentation:Manual:cadence_introduction.php b/Documentation:Manual:cadence_introduction.php index 4b75312..7416dd6 100644 --- a/Documentation:Manual:cadence_introduction.php +++ b/Documentation:Manual:cadence_introduction.php @@ -9,7 +9,6 @@ include_once("includes/header.php");

- 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.

@@ -23,7 +22,6 @@ Cadence controls and monitors various Linux sound systems as well as audio-relat

- 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.

@@ -33,8 +31,7 @@ This tells you the operating system, kernel version, and whether you are running

- -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. +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 is included by default in 12.04.3.

@@ -43,15 +40,16 @@ This lets you select the CPU Scaling Governor, a property of the Linux kernel wh

+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 and is also required to access FireWire devices. +

-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: - +

+The user created during installation of KXStudio 12.04.3 is automatically added into the audio and video groups but newly created users will not be part of these groups. You can add a user to the audio group by running: 

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. +Replace <username> with a KXStudio user name when you run that command in a terminal. You will then need to log out and back in or reboot before the user will be recognised as being in the audio group. Alternately, you can manage users and groups using the graphical kuser tool which is included with 12.04.3.

@@ -60,7 +58,6 @@ Replace <username> with your KXStudio user name when you run that command

- 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.

@@ -73,15 +70,15 @@ Replace <username> with your KXStudio user name when you run that command

-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. +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 at least minimize) 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. +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 size most decent quality audio 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. +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 require more disk space. Even for professional purposes, 48kHz is usually fine as the default. Additionally, 48 and 96Khz allow for lower latency than using 44.1 or 88.2 due to the way it is calculated.

@@ -94,7 +91,6 @@ Replace <username> with your KXStudio user name when you run that command

- Start Starts the JACK server, if its not running. This is the recommended way to start JACK.

@@ -124,8 +120,7 @@ Replace <username> with your KXStudio user name when you run that command

- -Cadences main window integrates the control of a few 'JACK bridges' -services which enable alternate Linux sound systems to run seemlessly atop JACK. +Cadence's main window integrates the control of a few 'JACK bridges' -services which enable alternate Linux sound systems to run seemlessly atop JACK.

@@ -137,8 +132,7 @@ 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. - +PulseAudio is not included by default with KXStudio and the PulseAudio bridge will not function until it has been installed. Most applications which use PA can use ALSA or JACK instead so there is often no need for PA and its bridge.

diff --git a/Documentation:Manual:downloading_and_booting_kxstudio.php b/Documentation:Manual:downloading_and_booting_kxstudio.php index fa00e56..2b4d695 100644 --- a/Documentation:Manual:downloading_and_booting_kxstudio.php +++ b/Documentation:Manual:downloading_and_booting_kxstudio.php @@ -9,7 +9,6 @@ include_once("includes/header.php");

- 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.

@@ -19,7 +18,6 @@ The easiest way to try KXStudio and discover if it supports your hardware is to

- Download the KXStudio Live-DVD images from:

@@ -45,12 +43,19 @@ With the exception of maybe a few (mainly Atom CPU-based) netbooks and tablets;

+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. +

-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. +

+The other option is to boot from a USB drive. USB drives are faster than DVDs and can be set to save updates and work and function as a working system; but you won't experience the full speed and capacity of KXStudio until you install it to a hard drive.

-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. +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 Easy2Boot,unetbootin or the Ubuntu Startup Disk Creator to transfer the iso file and make it boot from your USB drive. Easy2Boot requires a little more effort to set up than unetbootin or USDC but it allows you to boot multiple ISOs from a single USB drive, which is immensely useful. +

+ +

+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.

@@ -59,13 +64,11 @@ If using USB, you will need a FAT32 formatted USB drive with at least 2

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

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

diff --git a/Documentation:Manual:included_and_recommended_apps.php b/Documentation:Manual:included_and_recommended_apps.php index 6df8669..ae74d2c 100644 --- a/Documentation:Manual:included_and_recommended_apps.php +++ b/Documentation:Manual:included_and_recommended_apps.php @@ -9,7 +9,6 @@ include_once("includes/header.php");

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

@@ -27,7 +26,9 @@ Many of these apps are, or will be, included on the KXStudio DVD. Those not incl
  • Audacity Popular cross-platform sound editor but with poor JACK support
    • -
  • Avidemux Simple video editing and conversion tool ala Virtualdub
    +
  • Avidemux Simple video editing and conversion tool ala Virtualdub
    +
    • +
  • Bitwig Proprietary commercial DAW geared towards electronic music production
  • Blender 3D Powerful 3D modelling, animation, rendering and compositing
    • @@ -37,7 +38,7 @@ Many of these apps are, or will be, included on the KXStudio DVD. Those not incl
  • cadence-xycontroller Cadence-XY Controller is a simple XY widget that sends and receives data from Jack MIDI
    • -
  • Carla Audio plugin host (LADSPA, LV2, VST etc)
    +
  • Carla Audio plugin host (LADSPA, LV2, VST etc)
  • Catia Catia is a JACK Patchbay, with some neat features like A2J bridge support and JACK Transport
    • @@ -63,6 +64,8 @@ Many of these apps are, or will be, included on the KXStudio DVD. Those not incl
  • Guitarix JACK virtual guitar amplifier
    • +
  • gxtuner Instrument tuner
    +
  • Handbrake Cross-platform DVD ripping and video transcoding
  • Hydrogen JACK drum machine and sequencer, note: many additional drum-kits are available by installing the package “hydrogen-drumkits”
    @@ -123,6 +126,8 @@ Many of these apps are, or will be, included on the KXStudio DVD. Those not incl
  • scribus Professional layout and publishing software
    • +
  • setBfree Great sounding DSP B3 Hammond organ emulator LV2 plugin
    +
  • smplayer Excellent audio and video playback app
  • Soundkonverter batch audio file conversion
    @@ -137,6 +142,10 @@ Many of these apps are, or will be, included on the KXStudio DVD. Those not incl
  • TAL-Noisemaker Superb sounding, fully automatable softsynth plugin
    • +
  • Tracktion Commercial DAW with unique interface and free Linux version
    +
    • +
  • Triceratops Triple oscillator LV2 synth
    +
  • VLC The famous VLC media player
  • VMPK Virtual MIDI Piano Keyboard
    diff --git a/Documentation:Manual:installing_kxstudio.php b/Documentation:Manual:installing_kxstudio.php index f73fac5..9979d91 100644 --- a/Documentation:Manual:installing_kxstudio.php +++ b/Documentation:Manual:installing_kxstudio.php @@ -9,7 +9,6 @@ include_once("includes/header.php");

    - 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.

    @@ -23,7 +22,6 @@ There are a few important considerations you must be aware of before installing

    - 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.

    @@ -37,7 +35,6 @@ If you want to install KXStudio onto the same drive as an existing installation

    - 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.

    @@ -47,12 +44,11 @@ Many computers purchased since late 2011 use a technology called UEFI in place o

    - -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. +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.

    -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./ +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./

    @@ -61,13 +57,11 @@ The Boot-Repair process is documented

    - 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. -

    1. First, resize existing systems that you want to keep, if you have any
      @@ -94,8 +88,7 @@ To customize your partitions, run “GParted” from the KXStudio live session b

      - -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. +The KXStudio Live DVD is based upon Kubuntu 12.04.3 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, that is if you chose to 'Try KXStudio before installing' instead of choosing to run the installer directly at boot.

      @@ -112,8 +105,11 @@ If you did the advanced partitioning to separate your root and home, choose “m

      +After installing and booting KXStudio for the first time, you will see the KXStudio Welcome screen. It is recommended you choose 'Force reset of all settings' if you have just completed a fresh install. 'Update basic settings' may be useful to people running KXStudio Welcome on an existing installation or /home partition who don't want to replace all of their settings. +

      -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. +

      +Using the KX Welcome 'Update Theme' is known to cause text visibility issues for certain web sites and apps such a qtractor so use this option with caution. Update theme has a screenshot option that gives you a preview of what the desktop looks like with its modifications applied.

      @@ -122,20 +118,17 @@ After installing and booting KXStudio for the first time, you will see the KXStu

      - 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. +Super Grub2 Disk 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.

      @@ -144,13 +137,20 @@ Another useful tool to ease GRUB2 configuration is SSD optimization +

      Important notes for SSD users

      +If you have installed KXStudio onto an SSD, you may experience frequent stalls early in the boot process at the KXStudio boot splash screen. You can fix this by running: +

      +
      kdesudo kate /etc/default/grub
      -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. +

      +Remove the word 'splash' from the GRUB_CMDLINE_LINUX_DEFAULT options, save the file then update and re-install GRUB using the two commands from the previous multi-boot section. +

      +

      +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.

      diff --git a/Documentation:Manual:jack_configuration.php b/Documentation:Manual:jack_configuration.php index 4648f4a..b6f34a3 100644 --- a/Documentation:Manual:jack_configuration.php +++ b/Documentation:Manual:jack_configuration.php @@ -9,7 +9,6 @@ include_once("includes/header.php");

      - 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:

      @@ -23,12 +22,11 @@ Most of JACK's important configuration options are set within the Driver ta

      - 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. +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 onboard 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.

      @@ -37,7 +35,6 @@ The top 3 drop-down options within Cadence's ALSA driver configuration are

      - 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.

      @@ -63,7 +60,6 @@ Sample Rate, Buffer Size and Periods/Buffer determine the base JACK latency. The

      - 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.

      @@ -73,7 +69,6 @@ If JACK fails to start you can find out whats causing the problem by checking th

      - 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.

      @@ -83,7 +78,6 @@ kmix and alsamixer do not support FFADO. To adjust levels, enable phantom power

      - 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:

      @@ -93,7 +87,6 @@ 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
      diff --git a/Documentation:Manual:kxstudio_and_free_software.php b/Documentation:Manual:kxstudio_and_free_software.php index 6808eee..243b3a2 100644 --- a/Documentation:Manual:kxstudio_and_free_software.php +++ b/Documentation:Manual:kxstudio_and_free_software.php @@ -9,8 +9,7 @@ include_once("includes/header.php");

      - -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. +Along with the Debian and Ubuntu base systems 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.

      @@ -23,12 +22,11 @@ As KXStudio's primary purpose is to make the installation of a GNU/Linux-ba

      - -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 current KXStudio ISO 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. +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 need for the non-free Flash Player in the future.

      @@ -36,7 +34,7 @@ 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. +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.

      @@ -45,8 +43,11 @@ Some hardware manufacturers, particularly among wireless cards and graphics acce

      -The KXStudio non-free repository includes the following: +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 “/repo/ precise free non-free”. +

      +

      +The KXStudio non-free repository includes the following:

      • LightScribe support — LightScribe is a proprietary technology that uses specially made CDs and DVDs to allow users to burn direct-to-disc labels.
        @@ -87,21 +88,15 @@ 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. +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. +To remove non-free software from the package listings, choose “Configure Software Sources” under “Settings” in Muon Package Manager. There, you can uncheck the Proprietary drivers and multiverse (copyright or legally problematic) listings. On the “Other Software” tab, you can remove the Medibuntu and kxstudio.linuxaudio.org repositories.

        -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). - +If you want to use strictly 100% Free Software, there are several options. Instead of using the KXStudio ISO, KXStudio repositories can be added to any Debian-based system (which includes all Ubuntu-related systems) and you can leave out the separate non-free KXStudio repository. Debian itself is 100% Free (unless the user chooses to install extra non-free software). Additionally, FSF-endorsed distributions Trisquel (based on Ubuntu) and gNewSense (based on Debian) are also compatible with the KXStudioe repositories. Of these, only Debian is officially supported, but the others should work as well.

        diff --git a/Documentation:Manual:kxstudio_introduction.php b/Documentation:Manual:kxstudio_introduction.php index 4aa4153..076d82e 100644 --- a/Documentation:Manual:kxstudio_introduction.php +++ b/Documentation:Manual:kxstudio_introduction.php @@ -14,7 +14,6 @@ include_once("includes/header.php");

        - 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.

        @@ -24,7 +23,6 @@ KXStudio is a large and frequently updated collection of audio/visual software f

        - 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.

        @@ -34,12 +32,11 @@ This short manual was created for the KXStudio DVD or USB install. KXStudio work

        - -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. +The KXStudio distribution is based upon Ubuntu, one of the most popular variants of the GNU/Linux operating systems. Ubuntu is itself developed by a company called Canonical along with an extended global community of users and developers. An increasing number of third party software companies also offer software and support. While this manual focuses on installing KXStudio as a complete system, the KXStudio software repositories can also be added as a supplement to any Ubuntu- or Debian-based system.

        -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 /Donations . Thank you! +KXStudio began when a talented young Portuguese developer known online as falkTX saw the need for Ubuntu to have better management tools and software compilation for audio-related work. Over the years, falkTX's work has expanded to cover the base KXStudio project, the related suite of audio tools known as Cadence, the Carla plugin host, and the DISTRHO audio plugins. falkTX puts an incredible amount of time and effort into creating and supporting these and has also assisted in improving numerous other FLOSS projects. If you appreciate his ongoing hard work he would be grateful for any contributions you can make via /Donations . Thank you!

        @@ -48,12 +45,11 @@ Seeing a need for better audio/video integration in the system, a talented young

        - 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. +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.

        diff --git a/Documentation:Manual:latency.php b/Documentation:Manual:latency.php index 00c421e..6b49610 100644 --- a/Documentation:Manual:latency.php +++ b/Documentation:Manual:latency.php @@ -14,7 +14,6 @@ include_once("includes/header.php");

        - 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:

        @@ -69,31 +68,32 @@ Because these settings are not saved in the software to go with the interface ch
        -

        Disable wireless internet when recording

        +

        Disable wireless internet

        - 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.

        -

        Close browsers when recording

        +

        Close unnecessary programs

        +In general, avoid running unnecessary, CPU-intensive programs when recording. +

        -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. +

        +Many pop-up ads and popular web sites make use of Adobe Flash. If you have any browser tabs open, it only takes one to be using a little bit of Flash to cause a big loss of CPU, lower latency and more xruns. The easiest way to avoid this is to close any web browsers.

        -

        Avoid realtime resampling

        +

        Avoid realtime resampling

        - 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.

        @@ -103,20 +103,16 @@ You can check the sample rate of audio files using your favourite media player s
        -

        Check for IRQ conflicts

        +

        Check for IRQ conflicts

        - 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. - +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.

        diff --git a/Documentation:Manual:linux_audio_overview.php b/Documentation:Manual:linux_audio_overview.php index baaeb4b..f8c4727 100644 --- a/Documentation:Manual:linux_audio_overview.php +++ b/Documentation:Manual:linux_audio_overview.php @@ -9,7 +9,6 @@ include_once("includes/header.php");

        - 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.

        @@ -19,12 +18,11 @@ Anyone intending to use GNU/Linux as a platform for audio or video production wi

        - 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. +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.

        @@ -33,7 +31,6 @@ ALSA alone is insufficient for most AV production tasks because only one applica

        - 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.

        @@ -43,7 +40,6 @@ The

        - 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.

        @@ -53,9 +49,7 @@ The

        - 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. -

        diff --git a/Documentation:Manual:package_management.php b/Documentation:Manual:package_management.php index da52fbc..5273cf0 100644 --- a/Documentation:Manual:package_management.php +++ b/Documentation:Manual:package_management.php @@ -9,7 +9,6 @@ include_once("includes/header.php");

        - 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.

        @@ -18,7 +17,7 @@ KXStudio is based upon Ubuntu which is itself based on Debian GNU/Linux, so as a

        -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. +In KXStudio 12.04.3, the main package manager is called Muon. Muon is the easiest way to manage your software under KXStudio. KXStudio also includes the older Synaptic package manager and these instructions largely apply to that as well.

        @@ -27,7 +26,6 @@ In KXStudio 12.04.2, the main package manager is called Muon. M

        - 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.

        @@ -49,17 +47,15 @@ Most programs will be ready as soon as updating has finished. In the case of som

        - 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.

        -

        Installing packages via Muon

        +

        Installing packages via Muon

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

        @@ -68,7 +64,7 @@ When you have found the package you want, select it by clicking and then press t

        -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 the chosen app requires additional packages be installed for it to function, then you will be asked to confirm the installation of the required additional packages. These extra packages are referred to as 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.

        @@ -77,16 +73,15 @@ If you install a graphical application you should be able to find and run it by

        -

        Installing from a .deb package file

        +

        Installing from a .deb package file

        - -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. +There are many reasons why you should always try to install software from the repositories (or PPA's) rather than from .deb package files. Aside from saving time, using repositories ensures you are getting the correct packages for your distribution and then they will be automatically updated. In some cases, a .deb file will automatically install a repository to keep things updated, but not always. You will normally want to find repository versions or add PPA's to get software.

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

        @@ -99,7 +94,6 @@ Finding the correct package version is often the hardest part of installing from

        - 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.

        @@ -109,7 +103,6 @@ In Muon, search for the package you wish to remove then select 'Removal

        - 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.

        @@ -119,7 +112,6 @@ Removing a package will not remove the dependencies which may have been installe

        - The KXStudio repositories are themselves PPA's. In some cases, you may want to add new PPA's to your system.

        @@ -128,7 +120,7 @@ PPA's are especially useful if you want to help do beta testing or try pre-

        -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 +If a PPA is available, it will usually be listed on the projects website. For example, the latest stable release of LibreOffice isn't in the main repositories because it hasn't had completely thorough testing under this version of Ubuntu. LibreOffice offers a PPA for the stable version and another for beta testing. The address for the stable PPA is: ppa:libreoffice/ppa

        @@ -145,9 +137,7 @@ The maintainers of each PPA will keep your software up-to-date, so you only need

        - 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
        diff --git a/Documentation:Manual:simple_claudia_studio.php b/Documentation:Manual:simple_claudia_studio.php index 2044a90..47755f4 100644 --- a/Documentation:Manual:simple_claudia_studio.php +++ b/Documentation:Manual:simple_claudia_studio.php @@ -9,12 +9,11 @@ include_once("includes/header.php");

        - 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). +KXStudio includes an app called Claudia which uses the LADISH JACK session management protocol to save and restore JACK configurations or 'LADISH Studios'. Claudia is one of two JACK patchbay apps included in KXStudio for making and removing JACK connections. The other app is Catia, a simpler program with no canvas preview and no saved connections (and available for Windows and OSX, unlike Claudia).

        @@ -27,7 +26,6 @@ The use of Claudia and LADISH is best demonstrated with a simple example scenari

        - 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.

        @@ -41,7 +39,6 @@ Claudia's interface is divided into four main areas when a studio is loaded

        - 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.

        @@ -51,7 +48,6 @@ If you've not already got JACK running, then now is a good time to start it

        - 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.

        @@ -61,7 +57,6 @@ Now we shall add qtractor into our studio by choosing 'Add New…' fro

        - 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:

        @@ -75,12 +70,11 @@ We want this studio to automatically connect the outputs of alsa2jack (which out

        - -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 at boot, go to the main Cadence window, check that 'Auto-start JACK or LADISH at login' is ticked, and then click on the three dots to the right of this text. Choose 'Load LADISH studio', select the just-created qtractor studio and then push OK.

        -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. +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.

        diff --git a/Documentation:Manual:useful_links_and_getting_help.php b/Documentation:Manual:useful_links_and_getting_help.php index 4fe88e0..b27547e 100644 --- a/Documentation:Manual:useful_links_and_getting_help.php +++ b/Documentation:Manual:useful_links_and_getting_help.php @@ -15,25 +15,23 @@ include_once("includes/header.php");
        -

        KXStudio

        +

        KXStudio

        - For more info on the KXStudio applications such as Cadence, Claudia and Catia

        -/Applications +/KXStudio:Applications

        -

        Hardware Compatibility

        +

        Hardware Compatibility

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

        @@ -67,11 +65,10 @@ To check for the compatibility of your printer with the GNU/Linux printing syste
        -

        GNU/Linux software resources

        +

        GNU/Linux software resources

        - The Ubuntu package archive search

        @@ -113,11 +110,10 @@ The Wine Application Database (AppDB) details the compatibility of Windows progr
        -

        Recommended tutorials and guides

        +

        Recommended tutorials and guides

        - 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

        @@ -142,7 +138,7 @@ JACK was created mainly for Ardour which remains the most popular open source DA

        -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 +Those who prefer the more lightweight DAW qtractor will be happy to hear it has one of the best free manuals available for a free and open GNU/Linux app

        @@ -155,18 +151,16 @@ Those who prefer the more lightweight DAW qtractor will be happy to hear it has

        - -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. +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.

        -

        Fora and wikis

        +

        Fora and wikis

        - -If you get stuck, the first place to search for a solution is on the KXStudio forum +If you get stuck, the first place to search for a solution is on the KXStudio forum

        @@ -182,20 +176,19 @@ If you suspect its more of a general Ubuntu issue it would be a good idea to sea

        -The LinuxMusicians wiki contains all sorts of useful info for Linux audio users, including this manual +The LinuxAudio wiki contains all sorts of useful info for Linux audio users, including this manual

        -http://www.wiki.linuxmusicians.com +http://wiki.linuxaudio.org

        -

        IRC

        +

        IRC

        - 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.

        diff --git a/Documentation:Manual:video_drivers.php b/Documentation:Manual:video_drivers.php index 80dd55a..ab02916 100644 --- a/Documentation:Manual:video_drivers.php +++ b/Documentation:Manual:video_drivers.php @@ -9,7 +9,6 @@ include_once("includes/header.php");

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

        @@ -23,14 +22,11 @@ Intel drivers are open source but the official Nvidia and ATI/AMD drivers are pr

        - 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.

        @@ -40,7 +36,6 @@ lspci will 'List PCI' hardware installed on your machine, including yo

        - 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.

        @@ -50,13 +45,39 @@ When you run the Additional Drivers tool it will check the type of video hardwar
        -

        Nvidia video fixes and tweaks

        +

        Configure default laptop screen brightness

        +Lower laptop screen brightness settings conserve energy and increase battery life but sometimes visibility can suffer. A fresh install of KXStudio/Ubuntu defaults to the lowest brightness settings, for my laptop display at least, and I find it uncomfortable on anything other than its highest brightness setting so I set that to be the default at boot by running the command: +

        +
        kdesudo kate /etc/rc.local
        -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: +

        +and adding the line +

        +
        echo 7 > /sys/class/backlight/acpi_video0/brightness
        +

        +somewhere before the line that says 'exit 0'. This command sets the screen brightness to the max value of 7, the lowest brightness setting being 0. The file /sys/class/backlight/acpi_video0/max_brightness tells you what the max setting is. +

        + +

        +It's important to note that the path to the brightness setting as well as the values used may differ depending on your video hardware. laptop model and display config so you will have to check for the presence of these files and discover their correct locations before modifying rc.local. +

        + +
        + +

        Nvidia video fixes and tweaks

        +
        + +

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

        +
        kdesudo kate /usr/share/X11/xorg.conf.d/10-nvidia-brightness.conf
        + +

        +containing (copy/paste this into that .conf file) 

        Section "Device"
   Identifier     "Device0"
@@ -67,15 +88,17 @@ To enable the screen brightness control keys and disable the NVIDIA boot logo on
   Option "NoLogo" "true"
 EndSection
        +

        +Then, after rebooting, I could hold the Fn key and use the up/down arrow keys to adjust my laptop screen brightness. I don't think the VendorName and BoardName matter too much here and this change should work for anyone using the non-free Nvidia driver on a laptop. +

        +

        Additional AMD issues

        - -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 - +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 AMD Linux driver community wiki.

        diff --git a/Documentation:Manual:wineasio_and_reaper.php b/Documentation:Manual:wineasio_and_reaper.php index e1f9d5d..653a8e4 100644 --- a/Documentation:Manual:wineasio_and_reaper.php +++ b/Documentation:Manual:wineasio_and_reaper.php @@ -14,8 +14,7 @@ include_once("includes/header.php");

        - -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. +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. 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 currently for a specific task.

        @@ -24,7 +23,6 @@ KXStudio includes a program called Wine (Wine Is Not an Emulator) which allows m

        - 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.

        @@ -34,8 +32,7 @@ Audio Stream Input/Output (ASIO) is the most common low-latency sound card drive

        - -WineASIO provides a few options that can be configured within Cadence. These options are: +WineASIO provides various options that can be configured within Cadence. These options are:

        • Number of inputs
          @@ -53,8 +50,7 @@ WineASIO provides a few options that can be configured within Cadence. These opt

        - -(Cadence WineASIO settings screenshot: /screenshots/cadence4.png) +

        @@ -63,22 +59,17 @@ WineASIO provides a few options that can be configured within Cadence. These opt

        - -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: - +If you have run KXStudio Welcome Setup previously then you should already have the wineasio.dll library registered. Otherwise, for example if you have messed up or deleted your Wine configuration, you should run: 

        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. +You should only need to issue these commands once, if at all, but there is no harm in re-running them.

        @@ -87,12 +78,36 @@ You should only need to issue these commands once, if at all, and there is no ha

        - 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.

        +

        Installing REAPER

        +
        + +

        +You can download Reaper from the official website at http://reaper.fm/download.php +

        + +

        +If you are using a 32-bit system, choose windows installer for reaper 32bits and for a 64 bits, choose windows installer for reaper 64 bits. +

        + +

        +You can simply install reaper by double clicking on the file you just download and follow the steps shown in the window that should opened. +

        + +

        +Then be really carefull to NOT CHECK rearoute (ASIO driver) installation. Installing rearoute could result in a conflict with WineASIO. +

        + +

        +then don't forget to register wine as mentionned in the previsous chapter : Registering WineASIO libraries. +

        + +
        +

        Configure REAPER for WineASIO and JACK

          @@ -102,14 +117,22 @@ KXStudio includes the MS Windows version of
        1. Choose ASIO from the Audio drop-down menu at the top of the Audio device settings options. You should then see 'WineASIO Driver' is selected as the ASIO driver.
          2. -
        2. Choose Audio from the list to the left of the Preferences window and untick 'Close audio device when stopped and application is inactive'
          -
        3. Apply, OK, done!
        +

        REAPER / Claudia (or catia) issue

        +
        + +

        +To prevent some misconfiguration between REAPER and Cadence tools (Claudia or Catia), you have to set REAPER options. +So, in REAPER, go to options > Preferences, then click on Audio (in the left list panel) and uncheck “close audio device when stopped and applicatin is active”. +

        + +
        +