Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
This page will detail everything needed to setup and use your own edus2 system. It is fairly involved. This wiki will start out fairly bare, as questions arise, as well as interest in the system, the answers will be added here.
Step-by-step instructions to get your system going
Step 0: Get the supplies
Order yourself the stuff listed on the Hardware page.
Step 1: Download and install Ubuntu
For this tutorial, we will be using Ubuntu 15.10.
Go here and download the ubuntu-15.10-desktop-amd64.iso file. NOTE: edus2 does NOT work correctly with Ubuntu 16.04, so please do not install Ubuntu 16.04 or newer when trying to use edus2.
Burn this ISO file to a DVD, or if you're using a laptop without a DVD drive, copy the installer to a USB key.
For full details on installing Ubuntu check out the Ubuntu installation documentation
NOTE: Remember to record your username and password somewhere safe. For the truly bold, you can configure Ubuntu to boot directly into your user account so you don't have to type in this password every sim. If you decide to do this you still need the password to change system settings in the future.
Step 2: Install the prerequisite Ubuntu software
This step requires some knowledge of using linux and the command line, but an attempt has been made to simplify it for the non-hacker
Open the Terminal application. You may want to update the software sources to make sure any security holes are fixed (you can copy and paste this code into the Terminal if you are viewing this on Ubuntu):
sudo apt-get update sudo apt-get upgrade
From here you need to run a command to install the software that the edus2 application needs installed to work. mplayer will play the video for us; git is used to download the code from github. The following command will install both of these programs:
sudo apt-get install mplayer git
Test mplayer, the following command should result in information on mplayer being shown on screen:
The information shown should look something like this:
Lastly, we'll install another component that edus2 requires:
sudo apt-get install python-gtk2-dev
Step 3: Clone and install the software from github
Clone the repositories needed from github. This includes the py-mplayer bindings that edus2 uses to control mplayer from within the application as well as the edus2 code itself:
cd ~ mkdir src cd src git clone https://github.com/baudm/mplayer.py.git git clone https://github.com/asclepius/edus2.git
mplayer.py needs to be installed from the code we just downloaded. Enter the directory and run the setup script:
cd ~/src/mplayer.py/ sudo python setup.py install
Now we can download the videos from github (see the Scans page for accessing the videos individually:
cd ~/src/ git clone https://github.com/asclepius/edus2_video.git
[Optional] Step 4: Configuring edus2 for easy launching
Now that edus2 has been installed, we will create a desktop icon to easily launch the software. This step is optional, so you don't need to follow it if you don't want a desktop icon for edus2.
First, create a file in /src/edus2/ called runedus.sh and put the following code into the file:
#!/bin/bash GTK2_RC_FILES=/home/USERNAME/src/edus2/themes/Clearlooks-DarkCoffee2/gtk-2.0/gtkrc python /home/USERNAME/src/edus2/EDUS2.py
Be sure to replace all instances of USERNAME in the above code with the username that you use to log into Ubuntu with.
Next, close the text editor window and find the file in Files (The filing cabinet icon on the left bar). Left click on the runedus.sh file. Select Properties. Then select Permissions. Check the box titled Execute “Allow executing file as a program”
Create a file on the desktop called EDUS2.desktop with the following code. Change USERNAME to your account name.
[Desktop Entry] Encoding=UTF-8 Name=EDUS2 Comment=Desktop Icon Launcher for EDUS2 Icon= Exec=/home/USERNAME/src/edus2/runedus.sh Terminal=false Type=Application
Optional: Find a .png icon file to use as the launcher icon. Save the icon to the EDUS2 folder and link it by modifying the "Icon=" line in the code above to the following:
- Left click on the runedus.sh file on the desktop. Select Properties. Then select Permissions. Check the box titled Execute “Allow executing file as a program”
- Double click the EDUS2 icon on the desktop to ensure its working.
[Optional] Step 5: Configuring edus2 to automatically start on boot
For this to work correctly, you must have completed step four above. We will also go through steps for auto-launching edus2 when the computer starts up. These steps are optional, so don't feel that you need to follow them if you don't want edus2 to start automatically when the computer starts up.
Click the Search icon on the left bar in Ubuntu (The top icon on the left bar by default)
Search for "Startup Applications" and then open it.
Click "Add". Fill in the following information, and make sure that you change USERNAME to your Ubuntu account name:
Name: EDUS2 Command: /home/USERNAME/src/edus2/runedus.sh Comment: Autostart for edus2.
Reboot the computer and test to ensure that edus2 autostarts.
Step 6: Configure the program
Now we need to setup the RFID cards you purchased so that the edus2 software recognizes them and brings up the scans desired.
First label the cards for each scan you want, the names of all the scans are listed on the edus2_video page. You might as well label all 27 wallet sized cards.
Fire up the software:
cd ~/src/edus2 ./EDUS2_wrapper.sh
For each card you must do the following (a simplification to this process is on going):
- Click "Settings"
- Click "Add"
- Type the scan name in
- Scan the card with your USB connected probe
- Select the file associated with that name
- Click "Apply"