|
|
| (2 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| − | __NOTOC__
| |
| − |
| |
| | =Deprecated= | | =Deprecated= |
| | | | |
| | Warning: This project is no longer mantained and the content of this page is out of date. | | Warning: This project is no longer mantained and the content of this page is out of date. |
| | | | |
| − | | + | See https://github.com/moddevices/mod-live-usb/ for a similar project<br> |
| − | ----
| + | Still work in progress and very experimental |
| − | | |
| − | | |
| − | | |
| − | | |
| − | | |
| − | The Live-MOD is a [[Wikipedia:Live_CD|linux-based livecd]].<br/>
| |
| − | It boots a demo MOD system on most modern computers, allowing users to get a feel of the MOD experience without having the actual MOD hardware.
| |
| − | | |
| − | This live system consists of an [[Wikipedia:ISO_image|ISO image]], which can be burned into a CD/DVD or written into a USB drive.<br/>
| |
| − | You'll need to reboot your computer with the disk or USB drive plugged in, more details on the "How to boot" section below.
| |
| − | | |
| − | == Download and deploy ==
| |
| − | | |
| − | The current release is 2015.08-alpha1.
| |
| − | As the name says, it's an '''alpha release'''.
| |
| − | | |
| − | The download url is:
| |
| − | [https://github.com/moddevices/mod-iso/releases/download/2015.08-alpha1/Live-MOD_2015.08-alpha1.iso https://github.com/moddevices/mod-iso/releases/download/2015.08-alpha1/Live-MOD_2015.08-alpha1.iso].<br/>
| |
| − | If you want to verify the download completed successfully, the md5sum is '45a07166a3888da8f5ea86edb81d669c'.
| |
| − | | |
| − | You can burn the image into a CD/DVD or use a USB stick.
| |
| − | | |
| − | To burn the ISO image into a CD or DVD see [https://help.ubuntu.com/community/BurningIsoHowto this Ubuntu documentation page].<br/>
| |
| − | The method of burning ISO images is always the same independently of the ISO image contents.
| |
| − | | |
| − | For creating a bootable USB stick please see the information below.<br/>
| |
| − | There are different instructions for Linux, Mac OS and Windows.
| |
| − | | |
| − | The next step will be to actually boot from Live-MOD.<br/>
| |
| − | This method changes from system to system, but usually you press F8 or change the boot parameters in the BIOS/UEFI screen.<br/>
| |
| − | If you use Apple hardware you can simply hold the 'Alt' key and select the new boot drive that appears.
| |
| − | | |
| − | You can report issues related to Live-MOD here: https://github.com/moddevices/mod-iso/issues
| |
| − | | |
| − | == Create a bootable USB stick on Linux ==
| |
| − | | |
| − | On Linux we can use the 'dd' command-line utility. Simply do:
| |
| − | | |
| − | <code>
| |
| − | sudo dd if='/path/to/live-mod.iso' of='/dev/sdX'
| |
| − | </code>
| |
| − | | |
| − | Where '/path/to/live-mod.iso' is the full path to the live-mod iso image, and '/dev/sdX' is the device node for the USB drive.<br/>
| |
| − | Note that you '''must not''' use a partition number after the device node, like /dev/sdX1.
| |
| − | | |
| − | To find out what's the correct 'X' number in 'sdX' you can run this command:
| |
| − | | |
| − | <code>
| |
| − | sudo blkid
| |
| − | </code>
| |
| − | | |
| − | == Create a bootable USB stick on Mac OS ==
| |
| − | | |
| − | On Mac OS we can use the 'dd' command-line utility. Simply do:
| |
| − | | |
| − | <code>sudo dd if='/path/to/live-mod.iso' of='/dev/diskN' bs=1m</code>
| |
| − | | |
| − | Where '/path/to/live-mod.iso' is the full path to the live-mod iso image, and '/dev/diskN' is the device node for the USB drive.<br/>
| |
| − | Note that you '''must not''' use a partition id after the device node, like /dev/diskNs0.
| |
| − | | |
| − | To find out what's the correct 'X' number in 'sdX' you can run this command:
| |
| − | | |
| − | <code>
| |
| − | diskutil list
| |
| − | </code>
| |
| − | | |
| − | If you see the error:
| |
| − | <blockquote>dd: Invalid number '1m'</blockquote>
| |
| − | You are using GNU dd. Use the same command but replace <tt>bs=1m</tt> with <tt>bs=1M</tt>.
| |
| − | | |
| − | If you see the error:
| |
| − | <blockquote>dd: /dev/diskN: Resource busy</blockquote>
| |
| − | Make sure the disk is not in use. Start the 'Disk Utility.app' and unmount ('''don't eject''') the drive.
| |
| − | | |
| − | == Create a bootable USB stick on Windows ==
| |
| − | | |
| − | The easiest way to put Live-MOD onto your stick under Windows is to use the USB installer provided at [http://www.pendrivelinux.com/ pendrivelinux.com].<br/>
| |
| − | You’ll need to [http://www.pendrivelinux.com/universal-usb-installer-easy-as-1-2-3/#button download and install] and follow the instructions.
| |
| − | | |
| − | 1. Select 'Ubuntu' from the dropdown list
| |
| − | | |
| − | [[File:image-createausbstickonwindows-1.jpg]]
| |
| − | | |
| − | 2. Click 'Browse' and open the downloaded ISO file
| |
| − | | |
| − | [[File:image-createausbstickonwindows-2.jpg]]
| |
| − | | |
| − | 3. Choose the USB drive and click 'Create'
| |
| − | | |
| − | [[File:image-createausbstickonwindows-3.jpg]]
| |
| − | | |
| − | == Booting (non-Apple hardware) ==
| |
| − | | |
| − | When booting you'll see a black screen with a white MOD logo.<br/>
| |
| − | If you don't do anything Live-MOD will simply boot with the default options.
| |
| − | This screen looks like this:
| |
| − | | |
| − | [[File:live-iso_boot-01-start.png|frameless]]
| |
| − | | |
| − | | |
| − | Press any key at this point if you want to switch the keyboard layout or customize the boot parameters.<br/>
| |
| − | There's a special option for MacOS + Nvidia users here, and the option to skip booting Live-MOD in case you booted it by mistake.
| |
| − | | |
| − | [[File:live-iso_boot-02-key-pressed.png|frameless]]
| |
| − | | |
| − | | |
| − | If you press 'F3' to switch the keyboard layout, a menu with layouts will appear.<br/>
| |
| − | Navigate through the menu with the keyboard arrow keys and press 'Enter' to confirm.
| |
| − | | |
| − | [[File:live-iso_boot-03-select-keyboard.png|frameless]]
| |
| − | | |
| − | | |
| − | Press 'Enter' again to boot the selected option.
| |
| − | | |
| − | When the Live-ISO is actually booting, you'll see this screen:
| |
| − | | |
| − | [[File:live-iso_boot-04-booting-splash.png|frameless]]
| |
| − | | |
| − | | |
| − | Just a little longer and you'll be ready to have fun!
| |
| − | | |
| − | == Booting (Apple hardware) ==
| |
| − | | |
| − | When booting from Apple hardware the first screen you'll see will be similar to a Linux GRUB menu.
| |
| − | | |
| − | When this GRUB-like screen appears please select the 2nd option using your keyboard (the one that contains "MacOS + NVidia fix") and press 'Enter'.<br/>
| |
| − | In the future we'll make Apple hardware boot from this option automatically.
| |
| − | | |
| − | == Using Live-MOD ==
| |
| − | | |
| − | When Live-MOD is done booting you'll be shown a dialog asking you to select your soundcard.
| |
| − | | |
| − | Live-MOD tries to select the best soundcard automatically, but you may want to use something else from the list.<br/>
| |
| − | If unsure just go with the first entry.
| |
| − | | |
| − | Click 'ok' to confirm, and the MOD workspace will begin loading.
| |
| − | | |
| − | [[File:session-a01-welcome.png|frameless]]
| |
| − | | |
| − | | |
| − | There's 3 top tabs in Live-MOD: MOD Workspace, Dev Tools and Settings.
| |
| − | | |
| − | === MOD Workspace ===
| |
| − | | |
| − | MOD Workspace is where you'll spend most of your time, it's where everything about MOD happens.<br/>
| |
| − | For more information about how the MOD workspace works, see [[MOD_UI#Constructor]].
| |
| − | | |
| − | [[File:session-a02-mod-workspace.png|frameless]]
| |
| − | | |
| − | === Dev Tools ===
| |
| − | | |
| − | Dev Tools is a *temporary* place to help developers debug the Live-MOD, plugins and hardware stuff.<br/>
| |
| − | This top tab will be removed in the final Live-ISO builds.
| |
| − | | |
| − | [[File:session-a03-dev-tools.png|frameless]]
| |
| − | | |
| − | === Settings ===
| |
| − | | |
| − | Settings is your control panel for audio, midi and other miscellaneous things.
| |
| − | | |
| − | [[File:session-a04-audio-settings.png|frameless]]
| |
| − | [[File:session-a05-midi-settings.png|frameless]]
| |
