KXStudio Website https://kx.studio/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

152 lines
6.1KB

  1. <?php
  2. $PAGE_TITLE = "KXStudio : Documentation";
  3. $PAGE_TYPE = "NONKXSTUDIO";
  4. $PAGE_SOURCE_1 = ARRAY("/Documentation", "/Documentation", "/Documentation:Repository:Upgrade");
  5. $PAGE_SOURCE_2 = ARRAY("Documentation", "Repository", "Upgrade");
  6. include_once("includes/header.php");
  7. ?>
  8. <p>
  9. This section describes how to upgrade from a regular Ubuntu 12.04 install (or variants), to a cool and fresh KXStudio Desktop.<br />
  10. <span style="color:#fa3a3a;">This method will work *only* in Ubuntu 12.04 based systems</span>.
  11. </p>
  12. <p>
  13. KXStudio officially supports KDE4 and partially XFCE (on 12.04/12.10, KXStudio will use UbuntuStudio desktop as base as it uses XFCE).<br/>
  14. You can still install KXStudio if using any other Desktop Environment, but there's no meta-packages for them, and we'll not document the install process here.<br/>
  15. Create a new topic in the forums if you want support for other DEs.
  16. </p>
  17. <p><br/></p>
  18. <h5><span class="mw-headline" id="Step1">Step 1 - Enable the repositories</span></h5>
  19. <p>
  20. Open up the 'Software Sources' (usually in the System menu), and on the 3rd party separator, add this code:<br/>
  21. ppa:kxstudio-team/kxstudio<br/>
  22. Alternatively, you can run this command, which has the same effect:<br/>
  23. <code>
  24. sudo add-apt-repository ppa:kxstudio-team/kxstudio
  25. </code>
  26. </p>
  27. <p>
  28. Next, reload the sources (method depends on the current application), and install the package 'kxstudio-repos'. Then reload the sources again.<br />
  29. You can do the same thing in the command-line with:<br />
  30. <code>
  31. sudo apt-get update<br/>
  32. sudo apt-get install kxstudio-repos<br/>
  33. sudo apt-get update
  34. </code>
  35. </p>
  36. <p>
  37. 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.
  38. </p>
  39. <p><br/></p>
  40. <h5><span class="mw-headline" id="Step2">Step 2 - Update the system</span></h5>
  41. <p>
  42. 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!).
  43. </p>
  44. <p>
  45. Simply use whatever tool your Desktop Environment provides (Ubuntu Software Center, Synaptic, Update Manager, KPackageKit, Muon, etc).<br />
  46. If you want to use the command-line, or if you just got too many dependency conflicts (can happen if you enabled many PPAs before upgrading to KXStudio), the command is:<br />
  47. <code>
  48. sudo apt-get dist-upgrade
  49. </code><br/>
  50. Even though it says 'dist-upgrade', it will not update the Ubuntu version. In this case, 'dist' means something like "resolve conflicts, even if some stuff gets removed".<br />
  51. </p>
  52. <p>
  53. This step will take some time. Some minor questions may appear while the upgrade takes place.
  54. </p>
  55. <p><br/></p>
  56. <h5><span class="mw-headline" id="Step3">Step 3 - Install the KXStudio Desktop</span></h5>
  57. <p>
  58. After the upgrade, it's time to install the main KXStudio packages.<br />
  59. Just like you did to install the 'kxstudio-repos' package, now install:
  60. </p>
  61. <p>
  62. For KDE4 -&gt; 'kxstudio-desktop-kde4'<br />
  63. For XFCE -&gt; 'kxstudio-desktop-xfce'<br />
  64. For other systems install 'kxstudio-desktop-base' and the ubuntu related package, like 'lubuntu-desktop' for LXDE<br />
  65. </p>
  66. <p><br/></p>
  67. <h5><span class="mw-headline" id="Step4">Step 4 - Install the Multimedia Software</span></h5>
  68. <p>
  69. This step if almost optional. Here we install the basic software for Audio, Graphics and Video.<br />
  70. Just like before, it's time to install some new meta-packages. They are available as listed here (following a tree view of dependencies):
  71. </p>
  72. <ul>
  73. <li>kxstudio-meta-all</li>
  74. <ul>
  75. <li>kxstudio-meta-audio</li>
  76. <ul>
  77. <li>kxstudio-meta-audio-plugins</li>
  78. <ul>
  79. <li>kxstudio-meta-audio-plugins-dssi</li>
  80. <li>kxstudio-meta-audio-plugins-ladspa</li>
  81. <li>kxstudio-meta-audio-plugins-lv2</li>
  82. <li>kxstudio-meta-audio-plugins-vamp</li>
  83. <li>kxstudio-meta-audio-plugins-vst</li>
  84. </ul>
  85. </ul>
  86. <li>kxstudio-meta-graphics</li>
  87. <li>kxstudio-meta-video</li>
  88. </ul>
  89. <li>kxstudio-meta-codecs</li>
  90. <li>kxstudio-meta-restricted-extras</li>
  91. <li>kxstudio-meta-non-free</li>
  92. </ul>
  93. <p>
  94. Install the meta-packages you want just like before (ie, search for the package and click to install, or use in command-line: <code>sudo apt-get install &lt;package-name&gt;</code>)<br />
  95. See <a href="<?php echo $ROOT; ?>/Documentation:Ubuntu:Meta-Packages">Documentation:Ubuntu:Meta-Packages</a> for a description of these meta-packages.<br />
  96. </p>
  97. <p>
  98. Note - meta-all recommends restricted extras, and audio recommends audio-plugins.
  99. </p>
  100. <p><br/></p>
  101. <h5><span class="mw-headline" id="Step5">Step 5 - Install a Kernel (Optional)</span></h5>
  102. <p>
  103. This step is optional, and mostly useful for audio production only.<br />
  104. Installing a kernel in KXStudio couldn't be easier - just install one of these packages:
  105. </p>
  106. <ul>
  107. <li>kxstudio-kernel-generic</li>
  108. <li>kxstudio-kernel-generic-pae <i>(32bit only)</i></li>
  109. <li>kxstudio-kernel-lowlatency</li>
  110. <li>kxstudio-kernel-lowlatency-pae <i>(32bit only)</i></li>
  111. <li>kxstudio-kernel-realtime <i>(10.04 or 12.04)</i></li>
  112. <li>kxstudio-kernel-realtime-pae <i>(10.04 or 12.04, 32bit only)</i></li>
  113. </ul>
  114. <p>
  115. The realtime kernels are only available for 10.04 and 12.04.<br />
  116. Ubuntu 10.04 uses a 2.6.33 RT kernel and 12.04 uses a 3.2.0 one.
  117. </p>
  118. <p><br/></p>
  119. <h5><span class="mw-headline" id="Step6">Step 6 - Reboot and update settings</span></h5>
  120. <p>
  121. After all this, it's time to reboot.<br />
  122. The next time you login, you'll see the KXStudio Welcome Screen to help you update your settings (and maybe the theme too).<br />
  123. You should also run 'cadence' and change your JACK settings to your preference.<br />
  124. Finally, just re-login again after updating the settings.
  125. </p>
  126. <p><br/></p>
  127. <h5><span class="mw-headline" id="Step7">Step 7 - Enjoy!</span></h5>
  128. <p>
  129. Of course, now it's time to enjoy!
  130. </p>
  131. <p><br/></p>
  132. <?php
  133. include_once("includes/footer.php");
  134. ?>