NOTE: I have not been able to test this yet on Apple computers, as I run Ubuntu 12.04 on an Asus PC. If you run into problems with my portion of the tutorial (not the installation of Ubuntu into your virtual machine program), please leave a comment below or e-mail me at email@example.com.
This guide will help you install and run Gnoetry 0.2 in either a full Ubuntu Linux installation OR an Ubuntu virtual machine (using VMware or VirtualBox) or virtual partition (if you choose Wubi) installed in Windows or OSX. The process described here should allow for poets using any platform to run the Gnoetry 0.2 program.
For some idea of what the Gnoetry program can do, visit Beard of Bees Press and look at the Gnoetry collaborations published there or browse through the Gnoetry Daily weblog. The program is still in its development stage, so it is not all that simple to get it running. It is more complicated depending on your operating system.Gnoetry was originally written to run in Ubuntu using the Gnome desktop environment.
Related Resources: For a demonstration of how to open, setup, and work on a poem in Gnoetry 0.2, refer to this video: Gnoetry 0.2 Demo (YouTube). For instructions on adding your own source texts into Gnoetry, see this page: Adding Source Texts to Gnoetry.
If you have already installed Ubuntu as your main operating system, then you can begin with step one below and skip the preliminaries.
The following instructions should work in any recent installation of Ubuntu Linux (Tested in 9.04 – 12.04), whether it is fully installed to your computer or you are running Ubuntu from a LiveCD or from within a virtual machine running in Mac OS X or Windows, such as VMWare, Virtual Box, or another VM program. It is necessary that you be able to use the Internet from Ubuntu within VMWare/Virtual Box.
If you would like to use Ubuntu within OSX or Windows without fully installing it to your computer and replacing you current operating systerm, here are links to instructions for installing Ubuntu as a virtual machine on in OSX and Windows (there are others, and YouTube is a great resource as well):
- Windows: How To Run Ubuntu in Windows 7 with VMware Player | Installing Ubuntu inside Windows using VirtualBox
- Mac: How to Install & Run Ubuntu Linux in VirtualBox | How To Install VMWare Fusion with Ubuntu on a Mac
Help for this process may also be available by searching the Ubuntu Forums.
When you have finished with that process, you can begin with the steps below.
1. Download the Pre-Built Gnoetry Folder
— In your Ubuntu virtual installation, use Firefox to download the pre-built gnoetry program folder from this MediaFire Gnoetry Shared Folder.
— You should choose one of the x64 archive files (either zip or bz2, doesn’t matter) if you installed a 64-bit Ubuntu operating system in VMWare / VirtualBox. Choose the i686 archive if you installed 32-bit Ubuntu. If you don’t remember which Ubuntu architecture you installed, you can probably just go with the 32-bit version, then try the other if it fails.
— When prompted by Firefox about the download, choose the default option, which is for the file to be opened by Archive Manager.
2. Extracting the Gnoetry Program Folder from the Archive File
— Once Archive Manager opens, extract the archive downloaded in Step 1 to your Desktop.
3. Changing File Permissions to the Gnoetry Program Folder
— You should now see the gnoetry folder on your desktop after extracting. Follow these steps to change permissions for the whole folder:
— Right click on the gnoetry folder on your desktop and choose “Properties” from the menu.
— Go to the “Permissions” tab and check the box that says “Allow to execute as program.” This is sometimes a little glitchy; just click on it until you see a check mark.
— Now, still in the “Permissions” tab, click on the button below it which says “Apply Permissions to Enclosed Files.” This will ensure that no files which need these permission are without them.
— After clicking to “Apply Permissions to Enclosed Files,” you will see that the check mark you made has turned to a dash. This is fine.
4. Run Gnoetry in the Terminal
— Now you are ready to run gnoetry. Enter the Terminal and type:
This puts you in the new gnoetry directory.
— Make sure that the “D” is capitalized, as everything in the Terminal is case sensitive.
— Hit enter.
— Next, type:
— Hit Enter to execute the program.
— If all went well, you should now be at the first Gnoetry prompt to select the form of Gnoetry’s output.
[Post and Links Updated January 10, 2010]
If you want to try Gnoetry, but don’t feel up to building it yourself and installing Ubuntu alongside your other OS, there is a simpler option available using the Ubuntu Live CD option and the pre-built Gnoetry program folders below.
You will need a blank CD and a flash disk with ~250 MB of free space.
Also, I’m not sure if the LiveCD will work with Macs. I’ve not tested that yet.
Step 1: Download and Burn
Get the latest Ubuntu Desktop LiveCD. In recent Ubuntu versions, the LiveCD is included as an option in the installation disc, so download the correct image for your system (32 bit or 64 bit) and burn it to a blank CD. Make sure your burn the image to the disk and don’t just put the iso file onto a data cd (your burning software should have this option).
Next, download and extract the correct pre-built Gnoetry program folder from the MediaFire Gnoetry Shared Folder to a flash disk. The zip and tar.bz2 files contain the same things, just choose what you prefer.
- For 32 bit Ubuntu: gnoetry-0.2-i686-2.6 (zip or tar.bz2)
- For 64 bit Ubuntu: gnoetry-0.2-x64 (zip or tar.bz2)
When you extract it, make sure that you end up with the gnoetry directory in the base directory of you flash disk (not within some other folder).
Step 2: Open Ubuntu Live Session
Now that you have a burned LiveCD and a flash disk with Gnoetry on it, insert the LiveCD into your CD drive and restart your computer. Your computer should automatically boot from the CD (or ask you if you want to do this) and bring you to this screen:
Choose the first option, “Try Ubuntu without any change to your computer.” Once Ubuntu has loaded, insert your USB flash drive.
Step 3: Run Gnoetry in Terminal
Now open the Terminal (Applications -> Accessories -> Terminal). The flash disk is mounted at /media/disk, so you must do the following to get to gnoetry directory and run the program (don’t type the % signs):
% cd /media/disk/gnoetry/interface/
This is assuming that your gnoetry directory was extracted to the top directory of your flash drive in Step 1. If not, you will have to navigate to whatever directory you put it in.
That’s it! Enjoy the program.