~kiddo/knock-clock/main

<h1>Knock Clock</h1>

<p>This application is just a python script that starts playback with mplayer and stops as soon as you hit the keyboard. The goal is to have your computer behave like a real alarm clock that you can hit in the dark :) the time stuff is handled by gnome-schedule, whose job is to launch this script, "knock-clock".</p>

<p>knock-clock has the following dependencies: mplayer-nogui, gnome-schedule, gnome-terminal, and a working internet connection if you plan to leave the default "TARGET" setting. If your network connection is not available at the Moment of Awakening, knock-clock will instead play the terrible Ubuntu saxophone song in /usr/share/example-content/</p>

        <li>dowload this software manually by saving <a href="knock-clock">this file</a>, or by using <code>bzr checkout [this_website_address]</code> (for geeks)</li>

        <li>move the file (optional): <code>sudo mv knock-clock /usr/bin/knock-clock</code></li>

        <li>make sure it has executable permissions: <code>sudo chmod +x /usr/bin/knock-clock</code> or <code>chmod +x knock-clock</code></li>

        <li>set up gnome-schedule to launch "knock-clock" at any desired time. <b>Make sure that the "No output" checkbox is deactivated</b> (otherwise the terminal will not be visible). You must <b>also add the display variable</b> for all this to work. And, finally, you need to pass this on to gnome-terminal. Yeah, this is messy, but it's the only way I could make it work (should be easier in gnome-schedule >2.1). So, the command you should add in gnome-schedule is: <code>export DISPLAY=:0 && gnome-terminal -x knock-clock</code></li>

 

<p>Knock Clock is Free and Open Source software by Jean-François Fortin Tam, distributed under the GNU GPL v3 license.</p>