Guitar tuner (JavaScript)Susanna Huhtanenihmis.suski@gmail.com2012Use GTK+ and GStreamer to build a simple guitar tuner application for GNOME.Rafael Ferreirarafael.f.f1@gmail.com2013Guitar tuner
In this tutorial we'll construct a small application, Guitar Tuner, using JavaScript and GTK+ and GStreamer. To do and run all the code examples yourself, you need an editor to write code in, terminal and GNOME 3. or higher installed into your computer.
GStreamer pipelines
Script for running the application
Libraries to import
Creating the main window for the application
Buttons for the tunes
Making the sounds with GStreamer
Connecting buttons to playSound
The whole program
Running the application form Terminal
After reading this tutorial, you should see this in your screen:
GStreamer pipelines
GStreamer is GNOME's multimedia framework — you can use it for playing, recording, and processing video, audio, webcam streams and the like. Here, we'll be using it to produce single-frequency tones.
Conceptually, GStreamer works as follows: You create a pipeline containing several processing elements going from the source to the sink (output). The source can be an image file, a video, or a music file, for example, and the output could be a widget or the soundcard.
Between source and sink, you can apply various filters and converters to handle effects, format conversions and so on. Each element of the pipeline has properties which can be used to change its behaviour.
An example GStreamer pipeline.
Script for running the application
This line tells how to run the script. It needs to be the first line of the code and it needs to be executable. To get the execution rights go to terminal and run in right folder: chmod +x scriptname. Or you can use the graphical filemanager. Just go to the right folder where your code is, right click you code file, choose properties, click the permissions tab and check the box for allow executing file as a program
Libraries to import
In order to have a working program we need to import a few GObject Introspection -libraries to our use. For working UI, we need Gtk and for Gstreamer to work we need Gst. These are imported in the beginning so we have them at use everywhere. Also in the beginning we import a construct Mainloop to handle the timeout to be used with the tuning sounds.
Creating the main window for the application
Importing Gtk and Gst is not enough, we need to initialize them in order to get them working. When Gtk and Gst are up and running we need to create the window for the application. Later we are going to put all the buttons for making sounds inside this window. In order to get the window showing, we need to tell it to show and we need also to run the code with the Gtk.main()
Buttons for the tunes
Because Gtk.Window can only contain a single widget, we need to create something under it to be able to add all the necessary buttons inside it. In this example we use Buttonbox. After creating the Buttonbox we create buttons with necessary labels. After we have the buttons we need to add them to the Buttonbox and the Buttonbox must be added to the Gtk.Window and everything in the Buttonbox must be shown.
After this stage you should have a window appearing to your screen showing 6 buttons. Right now the buttons don't do anything and we shall address that issue later. Before we can connect the button signals to something we need to code that something first.
Making the sounds with GStreamer
The first thing we need to do is decide what tunes we want to make when we push a button. The frequencies list takes care of that. After that we get to actually making the sounds with the function playSound. For function playSound we give as an input a frequency (that we just defined in the frequencies variable). First thing we need to construct is a pipeline, a source and a sink. For the source we set the frequency. To the pipeline we add both the source and the sink and then we tell it to keep playing. As a last thing we use the const Mainloop to get the pipeline to stop after a 500ms.
Now we have the method of playing a tune when clicking a button. Next well make the connections between pushing a button and playing the correct sound from that button.
Connecting buttons to playSound
The method of connecting button clicks to playSound with the correct tune
is by using the connect method of the button widget. So we choose a button
to be connected and type E.connect("clicked",
function(){playSound(frequencies.E);}); The connect
tells that when pushing E, something should happen. The clicked
tells the type of the signal happening to E and then in the
function(){}; we call playSound with the correct note that
should be associated with the button.
The whole program
So this is what all the parts combined looks like. When running this code, you should be able to tune your guitar (if you have correctly calibrated speakers).
Running the application form Terminal
To run this application open Terminal, go to the folder where your application is stored and then run