====== EAC Ubuntu Install Instructions ======
Official EAC Ubuntu install instructions.

These specs were tested on a 600 MHz machine with 256 MB of RAM.

====== USB Install Key ======
There should be a usb key floating around the shop with the label "UBU".

That key has the installation scripts, and the Scratch tarball.

====== Installation Steps ======
The steps outlined here will install everything + Scratch.

===== Main Installation =====

  - If you have the USB key, put it into the computer.
    * If we've lost the install script, the script can be re-created using the packages in the [[#Ubuntu Packages]] section, and you'll need to re-create the Scratch install script from the [[#Scratch Stuff]] section if we've lost that as well :-(
  - Go to the terminal, and cd to ''/media/Lexar''
  - Run ''./copy_scripts.sh''
    * All the stuff on the USB key will be copied to the hidden ''~/.bworks'' directory
  - Type ''cd ~/.bworks''
    * You can now unmount the USB key
  - Type ''./install_both.sh'' -- Do **not** use ''sudo''.
    * The first few steps will require user interaction.
    * After you answer about 3 questions, you can let the script run.
  - Follow up with the next sections, and stop when you get to [[#Appendix]]

===== Customize Scratch Menu =====
  * Put scratch in the GNOME toolbar by dragging/dropping the icon from the desktop to the toolbar.
  * Go to System -> Preference -> Main Menu, and put Scratch in the "Programming" menu by dragging the icon from the desktop.
  * Delete desktop icon!
  
===== Sanity Check Scratch =====

  * Double-click the new Scratch icon, and make sure that it starts up in a reasonable amount of time.
  * Go to File...Open
  * You should see a folder called "NatesFavoriteScratchPrograms".
  * Open the folder.
  * Select the 1st program called "Archery Champion".
  * Make sure it plays smoothly.

===== Customize Mail Icon =====
  * Make mail icon point to Bworks' alum.bworks.org mail URL.

===== Default Music Codec =====
  * Go to "Applications" on the main menu.
  * Go to "Sound and Video"
  * Go to "Audio Extractor"
  * Go to "Edit"  ..... "Preferences"
  * Choose the highlighted settings shown below (just one change)

{{:audio-format.png|}}

  * If time, configure Banshee to do the same thing.
    * Banshee is under Applications...Sound and Video
    * Edit ... Preferences

===== Openclipart Directories =====

This is necessary because the default install of Open Office looks in ''.bworks/.openOfficeBlah'' directory for Clip Art, and it's not installed there.  In fact, it has to be downloaded using the ''openclipart-openoffice.org'' package, and then Open Office needs to be pointed to the ''/usr/share/openclipart'' directory. :-(


  * Check if openclipart-openoffice.org is installed:
    *  ''dpkg -l | grep openclipart'' -- If nothing prints, you need to install it.  Go to next step.  If something prints out, you probably don't need to install openclipart.  Skip the next step.
    * openclipart-openoffice.org package has been added to the install script that's on the UBU usb key that floats around the office.  4/1/09
    * Install openclipart
      * ''sudo apt-get install openclipart-openoffice.org''
    * Make sure that ''/usr/share/openclipart/png'' directory exists.
    * Go into OpenOffice
      * Go to Tools ... Options, and select ''Paths'' from the menu.
      * Change/Add the ''usr/share/openclipart/png'' path to **both** the "Gallery" and the "Graphics" options.


====== Appendix ======
If you're following the install steps, stop here!

===== Ubuntu Packages =====
Shell-scriptyness was removed, but here are packages, and install commands

<code>
# Typing programs.
tuxtype ktouch
  
# Unison helps mentorship students keep their files in sync
# with USB.
unison unison-gtk

# Kolourpaint requires KDE libraries, but it's a really
# cool, easy to use paint program, like MS Paint.
kolourpaint
  
# Extra music goodies.
# These are on the whiteboard for review by our Volunteers, and will probably be trimmed down.
amarok banshee audacity audacious mplayer listen bmpx

# Drum Kit!!
hydrogen hydrogen-drumkits

# Gambas = Bill/Nate endorsed excellent programming tool
# like Visual Basic
gambas2

# Ruby - Nate-endorsed awesome programming tool
ruby ri rdoc irb
#mkdir -p ~/Documents/ruby
#mkdir -p ~/tmp
#cd ~/tmp
#wget http://www.ruby-doc.org/download/ruby-doc-bundle.tar.gz
#tar -C ~/Documents -xzvf ruby-doc-bundle.tar.gz

# ----- Geany --------------
geany

# Games
frozen-bubble

# Productivity Goodies
gnome-do

</code>

===== Scratch Stuff =====
Below is a script that downloads the tar file from Nate's wiki if scratch1.3.tgz has not already been downloaded.

  * **NOTE** There should be an *"UBU"* USB key in the shop with this script on it already!  See [[#Installation Instructions]] above!

If the script is not on the *UBU* USB key then:

  - Copy the script below into its own bash script (e.g. ''scratchInstall.sh'')
  - Make the script executable ''chmod 755 scratchInstall.sh''
  - If you already downloaded scratch1.3.tgz from http://notesmine.com/scratch_installer#scratch_1.3_installer then copy ''scratch1.3.tgz'' into the SAME DIRECTORY as ''scratchInstall.sh''.
  - If you have not downloaded scratch1.3.tgz, then this script automatically do it for you.
  - Run ''scratchInstall.sh''

This script is on the USB key, and should only be copied/pasted into a new script if the USB key is lost.
Plus, the MD5 sum is incorrect, because the scratch1.3.tgz file was updated on 1/28/2009, and the MD5 sum hasn't been corrected on this page. :-O

<code bash>
#!/bin/sh
if [ ! -f scratch1.3.tgz ]
then
   wget http://notesmine.com/_media/scratch1.3.tgz
fi

# Check MD5 sum
if [[ "`md5sum scratch1.3.tgz | grep -v cc0b355593ce39dd32810e9bd56779c9`" != "" ]]; then
    echo "Md5sum doesnt match! Exiting Script"
    exit 1
else
    echo "MD5 sum is g00t"
fi

# If anything prints out, that's BAD

tar xzvf scratch1.3.tgz
./scratch_install.pl
# Remove temporary install files.
rm ./scratch_install.pl
# Remove Scratch.tar.gz which is in the scratch1.3.tgz file, along
# with the perl installer.
rm -f ./Scratch.tar.gz

# Move the tgz file to somewhere safe.  
# Sometimes, kids mess w/Scratch folder.
# This copy can be used to restore it.
mkdir -p ~/.bworks

# Copy the scratch file and this install script to the bworks directory for backup.
cp scratch1.3.tgz ~/.bworks
cp $0 ~/.bworks

</code>

===== Wallpaper Stuff =====

 * **Note** Not done yet, we want to try a different wallpaper.

  * Get wallpaper from Byteworks wiki.
  * Put wallpaper in hidden directory in student's directory.
  
  mkdir -p ~/.bworks  
  cd ~/.bworks
  wget http://wiki.bworks.org/_media/byteworks_1280_1024.png

  * Now, go to the "Places" main menu in GNOME.
  * Choose "Home Folder"
  * In "View" menu, click "Show hidden files"
  * Go to .bworks directory.
  * Right-click on image, then choose "Image" ... "Set As Wallpaper" from the Image Viewer menu.
  * :!: Choose "Fill Screen", rather than "Stretch" or "Centered".

{{tag>eac installation ubuntu}}