doc/index.html

   1 <html>
   2
   3 <head>
   4 <title>Epichord</title>
   5
   6 <style type="text/css">
   7 h1 {font-family: sans-serif}
   8 h2 {font-family: sans-serif}
   9 h3 {font-family: sans-serif}
  10 p {font-family: sans-serif}
  11 </style>
  12
  13 </head>
  14
  15 <body>
  16
  17 <h1>Epichord</h1>
  18
  19 <h2>a midi sequencer</h2>
  20
  21 <h3>Description</h3>
  22
  23 <p>Epichord is a midi sequencer. It allows you to arrange midi patterns to be played on midi aware tools, record midi, and store/load arrangements to/from disk. It does not make sound or handle audio in any way. That is the job of other midi programs and hardware to which it can connect. Epichord is a clone of what seems like countless programs available on windows, as well as some attempts to bring this type of tool to linux. In particular, it emphasizes a plain and 'overused' user interface which I believe existing tools either ignored to pursue something better, or just ignored. Here is a partial list of programs which serve as inspiration for Epichord in various ways.</p>
  24
  25 <ul>
  26 <li><a href="http://www.google.com/search?&q=massiva">Massiva</a>: midi sequencer for windows - the sequencer I used when I was a kid. It's piano roll widget uses space between horizontal rules for white keys, and the horizontal rules themselves for black keys. This compresses the vertical space of the canvas while naturally exhibitting the key signature. It also leaves open the possibility of 'going chromatic' or out-of-key at any time since it does not omit keys. Epichord also uses the pattern block arranger of massiva and many other programs.</li>
  27
  28 <li><a href="http://www.cavestory.org/downloads_5.php">Orgmaker</a>: pixel's custom music maker for windows - while orgmaker is not a midi sequencer and epichord does not make sound alone, epichord tries to be obvious and easy to use at first sight. You will not be required to navigate menus or dialog boxes to start composing.</li>
  29
  30 <li><a href="http://www.google.com/search?q=fruity+loops">FruityLoops</a>: midi looper / DAW for windows - fruity loops' piano roll allowed editting of notes without switching tools, for the most part. This UI choice is ignored by most midi piano rolls widgets for linux midi sequencers. However Epichord is not a looper.</li>
  31
  32 <li><a href="http://non-sequencer.tuxfamily.org/">Non-Sequencer</a>: midi sequencer for linux - non requires minimal processing power and memory, allows real time editting of events even while recording, and dispatches midi with sample precision via JACK. This program addresses many of the existing flaws of linux sequencers: bloat and instability. Epichord wants to be like Non-Sequencer when it grows up, but with emphasis on the old style piano roll and pattern block interface.</li>
  33 </ul>
  34
  35 <h3>Screenshots</h3>
  36
  37 <p><a href="screen1.png"><img src="screen1t.png" /></a>song view</p>
  38 <p><a href="screen2.png"><img src="screen2t.png" /></a>pattern editor</p>
  39 <p><a href="screen3.png"><img src="screen3t.png" /></a>midi scope showing midi input</p>
  40 <p><a href="screen4.png"><img src="screen4t.png" /></a>midi scope showing midi file</p>
  41
  42 <h3>Features</h3>
  43
  44 <ul>
  45 <li>Mouse-driven editting. left click inserts, right click deletes. Move, resize, select, insert, delete, and copy/paste with the mouse and without switching tools.</li>
  46 <li>Keyboard input. Standard tracker layout for qwerty or you can customize it. Space bar is like a sustain pedal.</li>
  47 <li>Piano roll. Black key notes sit on the horizontal rules rather than in between, giving visual cue to their key signature and more easily treating notes as piano music.</li>
  48 <li>Event editor. See midi events and insert/delete/change them. Use a line to envelope controller values, pitch bends, note on/off velocity, etc.</li>
  49 <li>Enhanced recording. Re-record the same block many times by automatically clearing it each time the song loops or pushing a new 'take' that you can review later. Create or extend blocks automatically when you begin recording outside a block.
  50 <li>Block x-ray. See miniature patterns while you arrange them.</li>
  51 <li>Clone blocks. Blocks may share patterns, change one block and you change them all.</li>
  52 <li>Horizontal zoom. By pressing + and -.</li>
  53 <li>Mute blocks. CTRL click on a block to mute/unmute it. May facilitate seq24 style loop performance.</li>
  54 <li>N 4 time signature. You can set the number of beats per measure to break out of 4 4 time. Changing time signature during the song is not planned, but I am accepting implementations or ideas.</li>
  55 <li>Virtual keyboard. It is fairly simplistic, but is functionally equivalent to using the keyboard for input and recording. Hold space bar for sustain pedal.</li>
  56 <li>Record on channel. If you so desire, midi input can be automatically routed to tracks by midi channel rather than the to currently selected one.</li>
  57 <li>Midi pass-through. If you so desire, recorded midi can be directly dumped to the output as soon as it arrives for minimal latency.</li>
  58 <li>Midi scope. A widget that shows raw midi as it arrives with semi helpful annotations. This might have a use.</li>
  59 <li>Midi files. Import and export type 1 standard midi files.</li>
  60 <li>LASH. Save and restore entire sessions of linux audio apps, including their state and JACK connections.</li>
  61 <li>JACK transport(planned).</li>
  62
  63 </ul>
  64
  65
  66 <h3>Download</h3>
  67
  68 <p>Epichord currently changes too fast to release, and lacks many of the planned features. So download the latest git snapshot instead <a href="http://repo.or.cz/w/epichord.git">from here</a>.</p>
  69
  70 <p>If you would like to help fix bugs or add features, then you will want to clone the repo. Also, you can contribute your changes without my permission by using the "mob" branch. For information on how to clone, merge, commit, and push with git see <a href="http://git.or.cz/course/index.html">this guide</a>. The following command will provide you with a fully functional copy of the latest git repo.</p>
  71
  72 <code>git clone git://repo.or.cz/epichord.git</code>
  73
  74 <h3>Setup Guide</h3>
  75
  76 <p>Epichord uses JACK midi. This means you need a jack daemon running and probably a patch program to run it and connect it to synths.</p>
  77
  78 </html>