Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

The older, deprecated, ugly, faster version of fretboard

branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README
Fretboard,

    Copyright (c) 2009 Karim Hamidou <karim@lambda-expr.org>
    Based on gtkguitune, Copyright (c) 1999 Florian Berger	                  

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License Version 2 as
    published by the Free Software Foundation;

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


What is Fretboard ?
--------------------
   Fretboard is a program that lets you use a musical instrument as an
   input device.
   Fretboard works only under the X Window system, however, it may be
   possible to port it to other systems than linux.
   It consists of an oscilloscope which counts the passes between two
   trigger levels per time and calculates the corresponding frequency.

Resources
---------
   You need to have gtk and gtkmm (1.2.1 or later), as well as
   xautomation (http://hoopajoo.net/projects/xautomation.html)
   installed.
   
Customizing
-----------

   After having installed fretboard, you'll probably want to
   customize its behaviour. This is for that purpose that I
   added Python support to it. Each time a note is read,
   fretboard calls a python function named callback() defined
   in ~/.fretboard/fretboard-callback.py.
   For more informations, see the commented examples in the sampleconfig 
   directory.

Design
------
   Fretboard was _not_ properly designed. Don't read the code,
   don't try to modify it, especially during nights of full moon. 
   I had better things to do than to write beautiful code, 
   so I reused this code. Yes, it uses gtkmm though it's a daemon.
   Yes, it allocs loads of things it won't use like menus, etc. No I don't
   think I will fix it because it works, and that I have better things to
   do than fixing some unbeliveably ugly code (you don't belive me ? 
   open guitune.cc and go to line 445. Now, try to understand what does the
   function proc_audio).

How to build
------------
   (1) ./configure
   (2) make
   (3) make install
   (4) edit you startup files to launch the fretboard daemon
       on startup.

   ...ready? shred!
Something went wrong with that request. Please try again.