User:Tdang/XO Setup: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Old Setup ==
I'm just starting on the 767 setup. I never got completely up on the 708 setup.

For historical curiousity, I still have the info on my old [[User:Tdang/XO Setup 656|656 setup]].

== My XO Setup ==
== My XO Setup ==
XO Name: Abiyoyo
XO Name: Abiyoyo


Primary User Age: 38 (but same setup for 4-year-old's computer)
Primary User Age: 39 (but same setup for 5-year-old's computer)


Operating System: OLPC Fedora / Sugar
Operating System: OLPC Fedora / Sugar


Build: 656
Build: 708 (currently updating)


SD Card: None
SD Card: None
Line 12: Line 17:
Hardware Mods: None
Hardware Mods: None


Peripherals: little USB mouse, 1G USB stick
Peripherals: little USB mouse, 4G USB stick


Flash Player: ???
Pre-installed Activities Removed: None


Favorite Activities Added: ???
Flash Player: LNX 9.0.115.0


Essential Non-Sugar Software: ???
Favorite Activities Added: [[Speak]], [http://gcompris.net/incoming/xo/sudoku.activity.xo GCompris Sudoku]

Essential Non-Sugar Software:
* Firefox
* Flash player


Modifications:
Modifications:
* Installed Firefox
* Sugarized Firefox
* Installed Adobe Flash player
* Installed [http://www.lyx.org/ LyX] and [http://www.foolabs.com/xpdf/ Xpdf]
* Made gamepad keys zoom in Read
* Created homepage for Browse
* Prevent re-starting X
* Changed Home View background color
* Removed "Register" from Shutdown menu
* Disabled hot corners
* Added clock to Home View frame

== What I like about this setup ==
I'm trying to stay very close to the standard installation. That's partly for my curiosity, and partly so that any contributions I make will be applicable to the standard installation.

[[Browse]] is simply not good enough as a browser. I'll use it sometimes, particularly to install new activities. But its inability to search within a web page, and inability to handle useful pop-ups (required for attaching a file in gmail, for instance) make it not good enough.

Firefox seems a possibly good alternative. I just started using Firefox instead of [[Opera]], and so far the main appeal of Firefox is that I have it fully Sugarized.

The XO as a book-reader is fantastic. I read a lot of academic papers in PDF. With the slight modification to [[Read]] allowing me to zoom with the game keys as well as navigate, I can really use the XO in eBook mode.

The changes I've made to Sugar make it a bit more comfortable, and feel more fun and personal.

== What I dislike about this setup ==
I suspect that I'll buy into the [[Journal]] philosophy in time, but I'm not used to it yet, and so I miss directory trees.

[[Write]] is OK, but not good enough to make me want to work on it instead of NeoOffice on my iBook.

=== I need VPN ===

I need to be able to connect to my school with [[VPN]], in order to have full access to online resources. (Will [[User:Mistapotta/Hamachi|Hamachi]] work?)

=== I need a spreadsheet ===

Spreadsheets are so thoroughly handy. I was having trouble with Google Docs in Browse, havrn't tried it yet in Firefox.

=== Bloat ===

On my other computers, disk and memory space is pretty unconstrained. This means I can install stuff willy-nilly without worries.

On the XO, I ''should'' be more careful. But installing in the default way is so much easier. Particularly, I've installed Firefox and LyX in the default ways. I'm not sure how much of what I get by doing that is actually stuff I want.

For instance, Firefox installs 10M of perl. I don't think I need 10M of perl.

LyX I installed because I want [http://www.latex-project.org/ LaTeX] tools. But LyX is extreme overkill for that--it includes a fancy editor, which I don't use. However, installing all of it seemed the best way to get the things I did want.

Xpdf I installed because it's an easier way to view the pdf's generated than going back into Sugar and figuring out how to open the pdf in [[Read]]. That's pretty silly, duplicating something like pdf viewing.

So, I need to think hard about doing installs like this, or learn how to do more careful installs.

== How to duplicate my XO Setup ==

Most of what I do here is somewhat specific to build 656. For a different build, files might need to be edited differently.

If there are any mistakes you find in these instructions, please let me know.

=== Update the OS ===
Update the OS as soon as you reasonably can. This is because when you update the OS, you'll lose pretty much anything you've done with your XO.

Hopefully, the standard instructions on this will work for you...

If you're networked, you can use [[olpc-update]].

If you're not networked, or you're having trouble with olpc-update, you can do an [[activated upgrade]].

=== Get Familiar with Command Line ===
You need to be comfortable acting on the command line and editing files to do most of what's here.

If you need, I hope my [[User:Tdang/XO_Command_Line_Tips|command line tips]] are helpful.

=== Pick an Editor ===
I won't walk you through all the choices of text editor. Many like [[vi]], and there's other options like [[emacs]]. In principle it's possible to use the [[Write]] activity.

I use [[nano]]. It's not very powerful, but it's very intuitive.

To edit a file, type (for instance):
nano /usr/share/sugar/shell/view/frame/frameclock.py

==== nano Hints ====
Here's a couple of hints for using nano:
* To find out what line of a file you're on, hit Ctrl-C. That can be useful for following editing directions.
* To save a file without exiting, the command is Ctrl-O. But that doesn't work on the XO, since Ctrl-O brings you to the Journal. You can cheat by instead hitting (Esc, Esc)-O. That is, hit Esc twice, followed by O. If this is too awkward, just use Ctrl-X to save and exit, and then go back into the file again.

=== Install Firefox ===
([http://olpcnews.com/forum/index.php?topic=2395.msg19221#msg19221 Instructions] from samphilomath at OLPCNews forum)

Here's what you type:
su
nano /etc/yum.repos.d/olpc-koji-ship2.repo

Now you're editing an "exclude" file. Go down and erase firefox from the list. (and make sure to delete the comma which goes with it so that there aren't two commas in a row.)

Ctrl-X exits nano and saves.

At this point, you should exit all programs except Terminal. yum install can be memory-intensive, and it's annoying to have it quit midway on you.

Type:
yum install firefox

Follow the directions. When completed, type "exit" to stop being superuser.

==== Sugarize Firefox ====
([http://olpcnews.com/forum/index.php?topic=1555.msg12203#msg12203 Instructions] and helpful files from CatMoran at OLPCNews forum)

Type:
su
wget http://www.catmoran.com/olpc/libsugarize.so
chmod 755 libsugarize.so
wget http://www.catmoran.com/olpc/sug
chmod 755 sug
wget http://www.catmoran.com/olpc/ff.svg
./sug

If the above doesn't work because the catmoran.org domain is down, you may have luck by looking [http://olpcnews.com/forum/index.php?topic=1555.msg19217#msg19217 here].

* You'll be prompted for an activity name. Enter "Firefox"
* You'll be prompted for an icon file. Enter "ff.svg"
* You'll be prompted for the command to start the program. Enter "firefox". (This is case-sensitive, so enter it in all lowercase.)
* You'll be prompted for an organization path. Enter "org.mozilla ".

Now, reboot Sugar. (Hit Ctrl-Alt-Erase). There should be an activity icon which is "FF" in a circle.

==== Flash ====

I'm actually not positive about this.

A good while ago, I followed the instructions to [[Adobe Flash|install Flash]] for [[Browse]], as well as removing click-to-play (instructions on same page).

I did nothing special with regard to Flash after installing Firefox, and everything works well in both Firefox and Browse. So I assume that earlier installation was appropriate for Firefox as well.

==== Install LyX and Xpdf ====

Most of my XO setup is pretty generic, useful for lots of users.

These tools are pretty special-purpose. [http://www.latex-project.org/ LaTeX] is a set of powerful typesetting tools. I use it for my academic papers. If you want to find out more about it, you can leave a message on [[User_talk:Tdang|my talk page]].

I really don't want all of LyX. I don't use the editor, just editing in a simple text editor. However, it seemed like installing LyX was the easiest way to get the tools I needed.

I followed the instructions [http://sumidiot.blogspot.com/2008/03/latex-on-xo.html iamanidiot posted] about it. (There's some extra information on space used and such on [http://john.daltons.info/olpc/lyx.html John Dalton's post]). It's extremely simple.

Before doing it, you should exit all programs except Terminal. yum install can be memory-intensive, and it's annoying to have it quit midway on you. The installation can take a long time, so make sure you have the time.

su
yum install lyx
yum install xpdf
exit

Xpdf is a pdf-viewer which makes it easy to view the pdf's which you can create, while staying in the Terminal.

=== Modifying Activities ===

==== Give Browse a Home Page ====

I particularly wanted a real home page for my mostly-illiterate 4-year-old, so I could set up a page of links to his favorites rather than the default home page.

This might be too round-about, but it worked for me.

su
nano /usr/share/library-common/index.html

In that file, replace "/home/olpc/.library_pages/search/bundle_index.html" with "/home/olpc/.mozilla/home.html".

Then, you don't need--'''in fact you don't want'''--to be superuser any more.
exit
nano /home/olpc/.mozilla/home.html

Set up whatever kind of home page you want in that file. Or copy an existing home page from USB stick or whatever. You'll be able to modify it in the future without being superuser.

You can make the same file the home page for Firefox.

==== Gamepad Zoom in Read ====
([http://olpcnews.com/forum/index.php?topic=1437.0 Instructions from] braingram and Ben James Ben at OLPCNews])

I've actually noticed that this change isn't perfect, that sometimes the keys don't zoom. I believe it depends on which menu
bar is up top when you use the keys, but I'm not sure. I'll try to fix it, but still it's ''much'' better than nothing.

su
cp /usr/share/activities/Read.Activity/readactivity.py /usr/share/activities/Read.Activity/readactivity-bak.py
nano /usr/share/activities/Read.Activity/readactivity.py

In that file, go to line 388. (Almost at the end, remember Ctrl-C tell you the line number in nano.) Change the function there to match:
def _key_press_event_cb(self, widget, event):
keyname = gtk.gdk.keyval_name(event.keyval)
logging.debug("Keyname Press: %s, time: %s", keyname, event.time)
if keyname == 'KP_End':
self._view_toolbar._zoom_in_cb(self._view_toolbar._zoom_in)
return True
if keyname == 'KP_Home':
self._view_toolbar._zoom_out_cb(self._view_toolbar._zoom_out)
return True
if keyname == 'c' and event.state & gtk.gdk.CONTROL_MASK:
self._view.copy()

==== Adding Right-Hand Gamepad keys to BlockParty ====

This is really minor, but I still like it. [[BlockParty]] isn't a pre-installed activity, so you can do it without being superuser.

Initially, BlockParty is set up to work from the keyboard or the left-hand gamepad arrows for everything. That seems a bit awkward. Instead, I want to use the left-hand gamepad for left & right,and the right-hand gamepad for rotate & drop.

That requires changing two lines (lines 88 and 89) in /home/olpc/Activities/BlockParty.activity/BlockParty.py

Before:
drop_key = ['space', 'KP_Down', 'KP_Down']
rotate_key = ['Up', 'KP_Up', 'KP_Up']

After:
drop_key = ['space', 'KP_Page_Down']
rotate_key = ['Up', 'KP_Page_Up']

=== Tweaking Sugar ===
Some of the changes I've made are changes to the Sugar UI itself.

==== Pre-Tweaking Precaution ====

===== Prevent X Restarting =====

Before changing any Sugar files, I strongly recommend a precautionary change. By default, X (the graphical environment Sugar runs in) restarts itself automatically. That means if something goes wrong as Sugar is starting, it quits and dumps out to the console, and then restarts and so on loops and loops and it's very hard to fix.

[[Michael Stone]] gave me good advice to prevent this from happening [http://en.forum.laptop.org/viewtopic.php?f=2&t=2570#p8960 at the forum]. Before making any (even minor) tweaks to Sugar, I follow that advice. (You only need to do it once, of course.)

===== Make a backup copy of original file(s) =====

For safety's sake, in case you forget how to reverse what you did, or in case you really screw up, you probably should back up any Sugar files before modifying them. Just (for instance):
cp /usr/share/sugar/shell/view/frame/frame.py /usr/share/sugar/shell/view/frame/frame-bak.py

==== Practice Tweak--Background Color ====
Just to get familiar with making changes to Sugar, and because it's fun to personalize, how about changing the background color of the Home view?

su
cp /usr/share/sugar/shell/view/home/HomeBox.py /usr/share/sugar/shell/view/home/HomeBox-bak.py
nano /usr/share/sugar/shell/view/home/HomeBox.py

Line 45 will look something like
hippo.CanvasBox.__init__(self, background_color=0x34FF4AFF)

Go nuts changing the color. I'm pretty sure it's [http://en.wikipedia.org/wiki/RGBA_color_space RGBA] color. You can get help figuring out the hex for the color you like by using the color tool in the [[Paint]] activity. Whatever number you get there will be the first 6 characters (after the "0x") of the color number. The last two characters are for transparency, so if they're "FF", it's opaque and should look like it does in Paint.

==== Turn Off "Register" ====
Since we're never going to to register our XO's with a school server, we don't need to be reminded regularly. So we might as well take that out. It's a minor point, but it's also a minor edit.

Simply comment out the following lines in /usr/share/sugar/shell/view/frame/HomeBox.py:
# if not self._profile.is_registered():
# item = gtk.MenuItem(_('Register'))
# item.connect('activate', self._register_activate_cb)
# palette.menu.append(item)
# item.show()

==== Turn Off Hot Corners ====
There's at least one thing about the standard Sugar interface which most users want to change. (I think it might change by default in future updates.) The [[OLPC Human Interface Guidelines/The Laptop Experience/The Frame#Hot_Corners|hot corners]] are very annoying for me, and many others. They also feel unnecessary since you can accomplish the same thing(s) by pressing the special navigation buttons.

This requires just commenting out two lines in /usr/share/sugar/shell/view/frame/eventarea.py:
def _create_invisible(self, x, y, width, height):
invisible = gtk.Invisible()
# invisible.connect('enter-notify-event', self._enter_notify_cb)
# invisible.connect('leave-notify-event', self._leave_notify_cb)

That's all that's needed.

==== Add a Clock to Home View ====
It's very unusual these days to have any electronic device which doesn't tell you what time it is. There are a couple full-fledged clock activities ([[Clock activity|clock]] and [[Alarm Clock, Randomizing WAV/MP3|random tune alarm clock]]), but they're overkill for a constant clock.

To add a clock, I create one new file and modify one existing file. Both files are in /usr/share/sugar/shell/view/frame

The existing file which gets modified is zoomtoolbar.py. First, up top in the imports it needs:
from frameclock import FrameClock

Down actually in the code of zoomtoolbar.py:
palette = Palette(_('Activity'))
palette.props.invoker = FrameWidgetInvoker(button)
palette.set_group_id('frame')
button.set_palette(palette)
# new clock code here
clock = FrameClock("%a %b %d %I:%M %p") # Show day month date HH:MM AM/PM
# clock = FrameClock("%D %H:%M:%S") # show date & time through seconds
# self.insert(clock,0) # Put clock to left of navigation buttons
self.insert(clock,-1) # Put clock to right of navigation buttons
clock.show()
clock.start()

You see above that there are format choices. You can use [http://docs.python.org/lib/module-time.html time format] codes in the call to FrameClock() to get the format you like. And you can decide when you do insert(clock...) whether you want the clock on the left or the right of the navigation buttons.

This requires a definition of FrameClock, which happens in the new file, frameclock.py:
# frameclock -- a little digital clock widget for the Home frame
# Actually, there's nothing about this specific to that use, could
# be used as a widget anywhere.
# March 28, 2008 Timothy Dang
from gettext import gettext as _
import gtk
import time
import gobject
import string
import pango
class FrameClock(gtk.ToolItem):
def __init__(self,new_format="%D %H:%M:%S"):
gtk.ToolItem.__init__(self)
self.set_expand(True)
self.format=new_format
self.update_interval = 1000 # update every second (recommended)
def start(self):
self.label = gtk.Label(time.strftime(self.format))
self.add(self.label)
self.label.show()
self.update_timer = gobject.timeout_add(self.update_interval,self.update)
def update(self):
time_string = time.strftime(self.format)
self.label.set_markup("<big>"+time_string+"</big>")
self.label.show()
return 1 # This seems to be needed to continue the update_timer

That should give you something which looks like:
[[Image:FrameClockCropped.png|screenshot of Home View with clock on top frame bar]]

Latest revision as of 14:54, 22 December 2008

Old Setup

I'm just starting on the 767 setup. I never got completely up on the 708 setup.

For historical curiousity, I still have the info on my old 656 setup.

My XO Setup

XO Name: Abiyoyo

Primary User Age: 39 (but same setup for 5-year-old's computer)

Operating System: OLPC Fedora / Sugar

Build: 708 (currently updating)

SD Card: None

Hardware Mods: None

Peripherals: little USB mouse, 4G USB stick

Flash Player: ???

Favorite Activities Added: ???

Essential Non-Sugar Software:  ???

Modifications:

Retrieved from "http://wiki.laptop.org/mediawiki/index.php?title=User:Tdang/XO_Setup&oldid=188603"