MouseTrap Getting Started

Revision as of 16:32, 19 March 2013

Instructions for Getting Started

IRC Instructions

• server: freenode
• channel: foss2serve

Bug Tracking

• Create yourself a GNOME Bugzilla account
  • Go to https://bugzilla.gnome.org/createaccount.cgi.
  • Enter email address, and follow instructions in confirmation email.

Wiki Basics

• If you are new to Media Wiki, you can get a quick overview here. The box on the left labelled "Using MediaWiki" has helpful links.

Installing Fedora 18

• Note: This is for a complete wipeover an existing OS.

1. Make sure the computer is shut down. Plug in USB/put in CD with live boot on it.
   1. For a CD install, the computer should read and boot into the installation screen. Skip until step 5.
2. If booting from a USB, continue here. Quickly press key to enter BIOS options (F2 for Ubuntu for example) when prompt appears.
3. Find "Boot Options" section. Under the "Boot" tab in Ubuntu. From here you can either:
   1. Change the boot priorities to have the USB be option one. Click on the first slot and select your USB. It will auto-switch the two. Press key to save and restart.
   2. Find the "Boot Override" section (if there is one) and click on your USB.
4. Once you get to the grub selection screen upon boot, select Fedora (top option). If you encounter this after selecting Fedora from the grub list: error: file '/isolinux/vmlinuz0' not found / error: you need to load the kernel first / / Press any key to continue... , Continue this step; otherwise skip to step 5.
   1. Shut down computer. Turn back on and reboot original OS (or use another computer).
   2. Since I was installing over linux system, I opened the terminal.
   3. You can also open the location of the USB in your files so you know where it is/ where the files are. (easier to look through then on terminal)
   4. Type cd /media/usbname/EFI/BOOT ; ls . This will move you to the location of the file you need to editand display the files in the folder you are currently in. Make sure the "grub.cfg" file is listed.
   5. Type vi grub.cfg . You need to change the two occurences of "isolinux" to "syslinux".
      1. Move cursor over the "i" in isolinux and press "x" three times.
      2. Press "i" to enter Insert Mode .
      3. Type "sys" then press CTRL.
      4. Repeat for other occurence.
      5. Type ":x" to save and exit vi editor.
   6. Type "exit" to leave terminal. Shut down computer amd restart.
   7. Select Fedora from the grub list upon startup (assuming the USB boots first, otherwise do "Boot Override" again).
   8. The Fedora installer should start up. Set up accounts and passwords as you see fit and that it asks of you. Delete all things originally on the harddrive and allow for auto-partitioning. The install application is pretty self explanatory.

• I have not found any problems past here expect for the one stated above. Please add as you see fit :)

• Note: I did run into a weird "secure boot not enabled" error after fixing the initial error above, and then the screen would turn half green and not go any further. I had a friend help me and the second time he tried to boot it up, it went past the error and right into the installation screen. So, it kind of "fixed itself." I really don't know what was going on. Best guess would be something in the grub level of booting up but I didn't press this issue any further since I couldn't find any real answers and it worked the last time.

Alternative Install Instructions

• Note: This guide will have you download a Fedora Network Install CD ISO and create a bootable USB flash drive from the image, from which you will install Fedora over the internet connection. This install guide is intended for any computer capable of a) booting from USB, and b) running Fedora 18 and c) (for those with a lack of patience) a fast network connection.

1. Download the ISO image for the Fedora 18 Network Install CD from here http://fedoraproject.org/en/get-fedora-options#formats.

2. Instead of a CD/DVD, this guide uses a USB flash drive. Note that the Fedora-suggested LiveUSB tool is, in my experience, unreliable. In my case, it produces a USB stick that either a) is not recognized as bootable, or b) freezes at or after the "Secure boot not enabled" screen. So this guide suggests using the command line program dd instead (a nifty tool, which should already be installed if you're using a UNIX-based OS, that copies a disk image to a destination byte-for-byte). To put the .iso image onto a USB stick, execute the command:

# dd if=./Fedora-18-x86_64-netinst.iso of=/etc/rdisk1

3. You most likely need to login as root to do this (hence the # above). Note that I also put "r" before the device name (in the above example, I used rdisk1 instead of disk1). This enables direct access, which speeds things up considerably. If you're unsure of the location of the USB drive in the filesystem, use the command

$ fdisk -l

to find out the location of the USB flash drive.

4. dd will sit there apparently doing nothing. Don't worry -- dd can take a while (hence the reason this guide doesn't use the Live DVD ISO!).

5. After it's done, boot from the newly-minted bootable USB flash drive, follow the Anaconda install process, wait, and you're done.

• Note: To enable USB booting on your computer, check out the BIOS settings -- it's most likely in there.

Installing MouseTrap

1. Open a Terminal window
2. Before installing MouseTrap itself, you need to install necessary libraries: Run sudo yum install <packagename> for each of the following packages, selecting "yes" when asked:
   1. gnome-common
   2. glib2-devel
   3. intltool
   4. python-devel
   5. opencv-python
   6. python-xlib
3. To grab the original MouseTrap files, type git clone git://git.gnome.org/mousetrap. To grab Amber's mose recent fork, type git clone https://github.com/amberheilman/mousetrap.git.
4. Type cd mousetrap ; ls and make sure the "configure.in" file shows up in the list of file in the directory.
5. You need to verify two lines in this file. You may edit this file using gedit or vi: Type vi configure.in.
   1. You should see the following line: AM_CHECK_PYMOD(cv,,,[AC_MSG_ERROR(Could not find python module cv)]).
   2. If you have the following: AM_CHECK_PYMOD(opencv,,,[AC_MSG_ERROR(Could not find python module opencv)]), change "opencv" to "cv" the two times it appears in the line.
   3. Save the file and exit.
6. In the terminal window, type sudo ./autogen.sh.
7. Type make.
8. Type sudo make install.
9. Type cd src to enter the source directory.
10. Type mousetrap to run the mousetrap program.

• Note: You must run steps 7 & 8 again every time you pull a new and updated fork from github. To pull a new file: git pull https://github.com/amberheilman/mousetrap.git.