# &app; v&appversion; User Guide

## Introduction

Welcome to the start of an exciting journey!

Español! Jokosher is a simple to use, yet devilishly powerful Open Source audio workstation. With it you can create and record music, audio and other projects. Jokosher has been specifically designed around ease of use and helping you to ignore the software and concentrate on your projects. We have taken every step to make it as intuitive as possible, but naturally a user guide is always helpful in explaining the specifics. This is that user guide.

Jokosher is an organic piece of software and grows and improves gradually. Due to its Open Source foundation, different people from all over the world work on it to make it the best tool for creating audio and music easily. Likewise, this guide reflects that organic nature and also grows naturally. This guide presents you with a complete guide to the features and facilities available in Jokosher. As each new release pops its head over the horizon, this guide will explain the awesome new features you can use.

Like any Open Source project, Jokosher and this guide needs your help. Invariably in most Open Source projects, the documentation always falls behind and does not track the progress of the application it is documenting. We really, really don't want this to happen with Jokosher. Our lovingly crafted Jokosher is made for musicians, and we want it to be simple and easy to use, and this guide plays an essential role. If something is incorrect, outdated or just plain broken, roll up your sleeves and fix it. It will be a great contribution to this important project.

## Features

&app; offers you the following features, ensuring that your audio producing experience is smooth and versatile:

- Easy to use interface, designed from the ground up. Jokosher uses concepts and language familiar to musicians, and is a breeze to use.

- Simple editing with splitting, trimming and moving tools.

- Multi-track volume mixing with VU sliders.

- Import audio (Ogg Vorbis, MP3, FLAC, WAV and anything else supported by GStreamer) into your projects.

- A range of instruments can be added to a project, and instruments can be renamed. Instruments can also be muted and soloed easily.

- Export to MP3, Ogg Vorbis, FLAC, WAV and anything else GStreamer supports.

- Documentation (User Guide, FAQ, Tutorial) and User Community (Forums, IRC).

## Getting Started

### Starting &app;

You can start &app; in the following ways:

Applications menu

- Choose Sound & Video &app; .

Command line

- To start &app; from a command line, type the following command, then press Return:

  `jokosher` `filename.jokosher`

  where `filename.jokosher` is the name of the file you want to open.

### The &app; Welcome Dialog

When &app; starts, you see the following window.

#### &app; Welcome Dialog

Shows &app; Welcome dialog. Contains Recent Projects dialog, Create a New Project, Browse fro an Existing Project, Preferences and Quit.

The welcome dialog has a number of different facilities:

- Recent Projects - this list provides a simple means of accessing your most recent projects, with the most recent ones at the top. To load a project just double-click it.

- Create a New Project ‐ click this button to create a new &app; project. See Creating a New &app; Project below.

- Browse for an Existing Project ‐ this button pops up a file dialog box to allow you to find an existing project file on your computer. See Opening &app; Projects below.

- Preferences ‐ clicking this button displays the main &app; preferences window.

- Quit ‐ click this to exit out of &app;.

You know, some people really hate welcome dialogs like this, so we plonked a nice fat Don't show this on start-up tickbox. Tick it to never be pestered by the welcome dialog again. There are a few cool things you can configure for Jokosher start-up, see jokosher-main-configure for the juicy bits.

So, which option did you pick? Well, lets run through them...

### Creating a New Jokosher Project

You can create project by either selecting the Create a New Project button from the welcome dialog or by clicking File New Project in the main window.

A dialog box then appears and you are asked for some details:

- Project Name — enter a name for the project here. This is most likely going to be the song title or podcast title.

- Folder — select a folder where your project is held. Please note that the folder you select will have a new directory created for it. So, as an example, if you select /home/bob/projects for this option and your Project Name is Booya, a directory called booya inside /home/bob/projects will be created.

- Author — enter your name or the name of your band in this box. This is the author of the project.

When you have added these details, click the OK button to continue.

If this is your first time using Jokosher, jump to jokosher-main-window.

### Opening &app; Projects

You can open existing projects by either selecting Browse for an Existing Project from the Welcome Dialog or clicking File Open in the main window.

When you select this option, the GNOME file picker pops up. &app; projects are stored in a directory with the same name as the project. Inside that directory is a `.jokosher` file. Double click it to load it.

If this is your first time using Jokosher, jump to jokosher-main-window.

## The Main Jokosher Window

- jokosher-main-toolbar

- jokosher-main-menus

- jokosher-main-configure

The main Jokosher window is where the action happens:

### &app; Main Window

Shows &app; Main Window. Contains the Menus, the Toolbar, Click Track, Time Line, Time Display, Workspace Selector and Project Zoom area.

Unlike other less fun and fabulous multi-trackers, Jokosher does not inflict lots of itty-bitty windows on you. Here everything happens inside a single window, making it simple to see what is going on at any one time.

### The Toolbar

Below the menus are the main toolbar buttons. These buttons are nice and big to help you when perched over your desk holding your guitar. They do a bunch of interesting things:

- Add Instrument — click this button to add an instrument to the project. See .

- Rewind, Play, Forward, Record — these buttons control playback and recording.

- Time display — this shows the current elapsed time in the project. Time will be displayed in hours, minutes and seconds or bars, beats and ticks, depending on the time format you've chosen in the Project menu.

- Workspace Selector — these buttons allow you to switch between the two workspace views in Jokosher.

- Click Track — this feature generates a click that you can play along with. You can set speed in beats per minute and change time signature. (This feature is not currently implemented.)

- Time Line — this ruler gives you a visual representation of your project in time. The line will be marked off in measures or in seconds, depending on you current time format.

- Project Zoom — this area at the bottom of the main window will help you zoom in and out and scroll the project quickly. The minus and plus icons will zoom the time line out and in respectively. The center icon will return you to a medium zoom. Drag the scroll bar to move the visible area of your project if it doesn't all fit on the screen.

### The Menus

Along the top side of the screen you can see a bunch of menus. You can find virtually everything in those menus, and if you are stuck figuring out how to do something, flick through the menus.

#### File

- New — opens a new project in the existing window. If there are changes in the current project, you will be offered a chance to save it. To add an instrument to the open project, see .

- Open — opens an existing project. If there are changes in the current project, you will be offered a chance to save it.

- Save — saves the current project. This option quickly saves all information in the project including Undo and Redo history.

- Save As — same as Save above, but this option allows you to save the project under a different name.

- Close — closes the current project without closing Jokosher. Again, you'll get a chance to save the project if there are changes.

- Recent Projects — this submenu lists up to the last 8 projects opened in Jokosher. This is a convenient way to move quickly from one project to another.

- Mixdown Project — brings up a dialog that begins the final stage of your project - the mixdown. Choose a name for the output file, a location where you want it saved, and an output format. Jokosher will then mix the project and save it as a single audio file in your chosen format.

- Quit — quits Jokosher completely. You will get a chance to save any unsaved work.

#### Edit

- Undo — Undoes the last change that you made to the project.

- Redo — Redoes the last thing that was undone with Undo.

- Cut — Removes the selected object from the project and place it on the clipboard, replacing what was there previously.

- Copy — Puts a copy of the currently selected object on to the clipboard, replacing what was there previously.

- Paste — Places the contents of the clipboard into the project. See href="#Editing_Functions"Editing Functions below for details on selecting pieces of audio to cut, copy and paste.

- Delete — Removes the selected object from the project and discards it.

- Preferences — Opens the &app; Preferences window.

#### Project

- Add Instrument — see below

- Instrument Connections — This dialog lists each nstrument in the project and shows which input from your sound card is connected to that instrument. For each instrument you can change the connection by clicking the drop-down box and choosing an input to connect.

- Time Format — Selects how time is displayed on the Time Line. The options are Show as Bars, Beats, Ticks or Show as Hours, Minutes, Seconds.

#### Help

- Pre-release Notes — Tells you the latest information you'll need to know about this release of &app;.

- Contributing to &app; — Lists details on all the different ways to contribute to &app;. &app; is still in development and can always use your help.

- About

  - Credits — Opens a dialog box that lists the many people who have worked to bring you &app;.

  - License — The complete license for &app;.

### Configuring Jokosher Preferences

The Jokosher preferences menu can be found by clicking Edit Preferences . Here you can change many settings that determine how Jokosher works. Note that these settings will be saved for Jokosher globally, not on a per-project basis.

- General

  - Application Start-up — Chooses how &app; will act when it first starts. The three options are:

    - Show welcome dialog — the default. Choose this option if you'd like to pick a project every time Jokosher starts.

    - Open most recent project — Choose this option if you'd like to skip the welcome dialog and jump to the project you had open the last time you used &app;.

    - Don't open anything — Choose this option if you want total control. You can open a project later from the File menu.

  - Audio Quality — Gives two options, Sample Rate and Sample Format, that change the recording quality of Instruments in &app;. The choices available will depend on your sound card. With both options, higher numbers give better quality but also create larger files. Larger files take up more space, and may cause Jokosher to work more slowly when processing changes.

  - Audio Mixdown — Changes the Output Format used by &app; during href="#Mixdown_Project" mixdown. The output file will be saved in the chosen format. Available output formats will depend on which plugins you have installed on your system.

- Recording

  - File Saves As — Changes the format in which &app; saves recorded instruments while working on a project.

- Playback

  - Device — Changes the audio hardware used for playback. Again this depends on the hardware installed on your system. You may only have one option.

## The Recording Workspace

### Recording View

Inside the recording view, only the instruments are displayed. This is where you will spend most of your time recording, editing and re-recording.

Recording is the first step in the process of creating a project. You will add Instruments, usually one at a time, record audio into that Instrument, then add the next instrument. Working in the recording view usually follows the steps listed here:

#### Recording Functions

1. Add Instruments — See below for details on this process. After an Instrument is added, you will see that it has the following features:

   ##### Instrument Features

   Shows Instrument lane features. Contains Instrument Icon, Instrument label, Record, Mute and Solo buttons and Recording Lane.

   - Instrument Icon — the same icon you saw when you chose the Instrument.

   - Instrument Label — this can be changed at will simpy by clicking on it. It is just a label to identify the Instruments in case you have several with the same icon.

   - Record Button — this button will be clicked to "arm" the Instrument during recording.

   - Mute Button — this button will silence the Instrument during playback.

   - Solo Button — the opposite of the Mute button. When pressed, you will hear this Instrument as "solo" during playback, with all other Instruments muted.

   - Recording Lane - to the right of the buttons is an area here recorded audio will be displayed for this instrument.

2. Set Connections — as explained in href="#Instrument_Connections"Instrument Connections above, the different sound card inputs can be routed to different Instruments at will. In this way, even if there is only one input, by connecting it to each Instrument in turn multiple Instruments can be recorded.

3. Record — at this point you are ready to record this Instrument. If it's a live instrument, plug it in, press the Record button on the instrument to arm it, then hit the Record button on the main Toolbar. When done recording, click Stop. To record an existing audio file, right-click on the Instrument recording lane then click Import Audio File. Find the file you'd like to import, then click Open. Notice that the audio is now in the recording lane for that Instrument. The waveform shows you the volume level at any point in the recording.

4. Repeat — unarm this Instrument and begin the process again by adding the next Instrument until all .

#### Editing Functions

Once all Instruments are recorded, editing begins. Think of the Instruments as raw materials that you will shape into a final project. Jokosher offers several tools to help with editing.

- Move — this function shifts a piece of audio in time. To Move a piece of audio, click it and drag it left or right until it is in the desired position. When recording Instruments separately, this function can be used to get Instruments in synch with each other.

- In order to edit audio, a recording often needs to be broken up into pieces. &app; offers two main tools to do this:

  - Split — this function divides the audio in an Instrument into two sections. Use Split when you want to keep the entire recording, but need to break it into pieces. To split, double-click in the Instrument lane at the point where the audio should be divided.

  - Trim — this function deletes everything but a selected piece piece of audio. To Trim, hold down the Shift key, click with the mouse at the beginning of the section you'd like to Trim, drag the mouse to the right to the end of the desired section, and release both the Shift key and the mouse button. A Trim tab will appear below the selected section. Click this tab to Trim.

- Cut and Paste — this function moves pieces of audio from one place to another. If you don't want to Cut a complete recording, Split it into pieces or Trim as above to separate the piece you'd like to work with. Next click on the piece you'de like to Cut, click Ctrl X Edit Cut in the spot where this piece should go. Click Ctrl V Edit Paste .

- Copy and Paste — this function is used to make copies of the same audio in more than one place. It is similar to Cut and Paste above. First select a piece of audio, then click Ctrl C Edit Copy . Click in the spot where this piece should go. Click Ctrl V Edit Paste .

- Delete — this removes a piece of audio completely from a Project. Select the section you want to delete then click Edit Delete or hit the Delete key on the keyboard.