MouseTrap Getting Started

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 MediaWiki, 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. Type: cd This will put you in your home directory.
4. Type: git clone https://github.com/amberheilman/mousetrap.git
5. Type: cd mousetrap
6. Type: git checkout logan_test
7. Type: ./autogen.sh
8. Type: make
9. Type: sudo make install
10. Type: cd src
11. Type: mousetrap This will fail the first time, but is needed to create the userSettings.cfg file in the next step.
12. Open a text editor (vim command workds) and open the file at: ~/.mousetrap/userSettings.cfg
    1. Set the showPointMapper to False.
    2. Save and close file.
13. Type: mousetrap which should run mousetrap.

• Note: You must run steps 7-12 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.

Following MouseTrap Bugs

To be notified via email of any activity on bugs related to MouseTrap, do the following:

1. Log into http://bugzilla.gnome.org
2. Select the Preferences link
3. Select the Email Preferences tag
4. At the bottom of the page, find the Add users to my watch list and enter mousetrap-maint@gnome.bugs
5. Click Submit Changes