Xo-get: Difference between revisions

Latest revision as of 18:11, 20 November 2011

XO-Get is a very simple package-installer / manager, used for installing, testing and removing activities for / on the xo-laptop and emulators.

News: We are currently developing a Graphical User Interface with PyGTK

About xo-get

Supported commands

Run this within Sugar in Terminal activity as user

(not as root nor su nor sudo)

./xo-get.py update
./xo-get.py list     ['categories' / category_name]
./xo-get.py search   keyword
./xo-get.py install  activity_name / activity_file.xo
./xo-get.py remove   activity_name / activity_file.xo / activity_directory
./xo-get.py start    activity_name
./xo-get.py status   ['log']

Explanation:

update	Updates the Database
list	Lists installable Activities
search	Searches for tags, names, descriptions
install	Installs the given Activity
remove	Removes an Activity
start	Starts Activity
status	List all installed Activities

Usage

Installation of xo-get

wget http://xo-get.olpc.at/xo-get.py
chmod u+x xo-get.py

Update the xo-get repository database

./xo-get.py update

Installation of xo-get GUI

./xo-get.py install xo-get

Note: Joyride 1702, although it installed ok. When i click on the frame icon to run it. Flashes for awhile, then goes away. I ran it in terminal by xo-get.py start xo-get and appears to run ok. (Filing some bugs and suggestions too. :) --ixo 02:11, 17 February 2008 (EST)

sugar-install-bundle/media/<usb stick name>

Usage Examples

List installed Activities

./xo-get.py status

Installing & Removing

./xo-get.py install simcity
./xo-get.py remove simcity

Local .xo files

./xo-get install simcity.xo
./xo-get remove simcity.xo

Name Assistant

Search, list, install and remove activities with typing only the beginning of the activity's/category's name as parameter

List the category "Fun Games":

./xo-get.py list fun

Install CC Licensing Activity:

./xo-get.py install cc

Removing simcity

./xo-get.py remove simc

GCompris

List GCompris activities:

./xo-get.py list gcompris

Install GCompris activities:

./xo-get install gcompris-...

Install all GCompris activities (> 100):

./xo-get install gcompris

Repositories

Newer versions of xo-get (>1.0) use a central repository (xml), which is synced daily with the sub-'repositories'. Advantages of this structure are

'xo-get update' will not break on changes in the repositories
supplying with filesizes and system-names (which sometimes differ from the wiki-names)
much less traffic on updates
backup repositories

Repository Listing:

It's possible to add / change repositories on request (mail). Also, any ideas for further developments are welcome!

Bugs / Issues

Please file a ticket for any bug you find to the 'xo-get' component here: http://dev.laptop.org/newticket

Feature Request / Wishlist

Add an item

Improvements

Position Quit-button the standard way / use the Toolbar
Better Installation and Removal Feedback
Auto-Refresh, Refresh with graphical representation
Bigger Scrollbars / Autoscroll on KeyDown
Less scrolling: Wrap Description, Changable width of columns
Better "Information": Icon, Version Number
Highlight Activities without checking
Hide Apply Button after Installation (which does nothing)
- Change the "Close" button label to "Show List". "Close" currently implies closing the application given the current context of the application and the full screen dialog box.
checkbox for showing version #.
Legend.. what the heck does the (*) mean ???
Group activities by, and alpha sort list (Allow collapsible groups)
- Base pre-installed, non-removable
- Installed Activities
- Groups of packaged activities, such as GCompris
Arrow keys
- Left/Right - scroll left/right
- Up/Down - scroll up/down
Remove all custom packages, [Button] (except of course xo-get :)

New Features

Self-Update screen for the GUI
Preferences
- where to save files
- clean old .xo's
GUI: Install .xo from disk / usb
Button for 'check for Activity updates' (compare installed versions with versions available)
- Button for 'update all'
Add entries for installed activities in the Journal for a common deletion/removal mechanism.

Changelog

1.2.3: Switched to one central repository, lots of minor fixes

Contributors

Author

Chris Hager (chris at linuxuser dot at)

Testering

Jaume Nualart
ixo - testering as much as I can. Submitted bug reports.

If you have ideas *and* some spare time: contact us! This project is open for anyone :-)

Caption1
Caption2

@@ Line 1: / Line 1: @@
+<table border="0">
-'''''News:''''' GTK [[Xo-get-gtk|Graphical User Interface]] ([http://dev.laptop.org/git?p=projects/xo-get;a=blob;f=xoget.activity/xoget.xo xoget.xo])
+  <tr>
+    <td valign="top">__TOC__</td>
+    <td valign="top" style="padding:10px 26px;">[[Image:activity-xoget.png]]</td>
+    <td valign="top" style="width:300px; text-align:center;">
+'''<font color="green">XO-Get</font>''' is a very simple package-installer / manager, used for installing, testing and removing activities for / on the xo-laptop and emulators.
+'''<font color="green">News</font>''': We are currently developing a [[Xo-get/Xo-get-gtk|Graphical User Interface]] with [[PyGTK]]</td>
+  </tr>
+</table>
+== About xo-get ==
+* [http://www.olpc-europe.org/browse/xo-get.py  xo-get.py] (GPL)
+* [http://dev.laptop.org/git?p=projects/xo-get;a=tree Source Tree]
+* [http://xo-get.olpc.at/repository/ Activity Repositories]
+* [[Xo-get/Xo-get-gtk|Graphical User Interface]]
+== Supported commands ==
+Run this within Sugar in Terminal activity as user
+(not as root nor su nor sudo)
-=== XO-Get ===
-is a very simple package-installer / manager, used for installing, testing and removing activities for / on the xo-laptop.
-'''Installation''':
- wget xo-get.olpc.at
- chmod u+x xo-get.py
-# [http://dev.laptop.org/git?p=projects/xo-get;a=blob;f=xo-get.py Source] (GPL)
-# [http://www.olpcaustria.org/mediawiki/index.php/Xo-get/Screenshots Screenshots]
-# Activity Repository: [[Activities]]
-# Source Repository: [http://dev.laptop.org/git?p=projects/xo-get;a=tree dev.laptop.org]
-# Can install GCompris activities
-# Installing & removing via local .xo files or downloaded bundles
-# ActivityBundle.install(), Unzipping, ActivityBundle.uninstall()
-# Infos stored in a local sqlite3 db (in ~/.xo_get/activities.db)
-# Supported commands:
  ./xo-get.py update
  ./xo-get.py list     ['categories' / category_name]
- ./xo-get.py search   activity_name / tag
+ ./xo-get.py search   keyword
  ./xo-get.py install  activity_name / activity_file.xo
- ./xo-get.py remove   activity_name / activity_file.xo
+ ./xo-get.py remove   activity_name / activity_file.xo / activity_directory
+ ./xo-get.py start    activity_name
  ./xo-get.py status   ['log']
+'''Explanation:'''
+: <table border="0"><tr><td style="width:70px;">''update''</td><td>Updates the Database</td></tr><tr><td>''list''</td><td>Lists installable Activities</td></tr><tr><td>''search''</td><td>Searches for tags, names, descriptions</td></tr><tr><td>''install''</td><td>Installs the given Activity</td></tr><tr><td>''remove''</td><td>Removes an Activity</td></tr><tr><td>''start''</td><td>Starts Activity</td></tr><tr><td>''status''</td><td>List all installed Activities</td></tr></table>
+== Usage ==
+=== Installation of xo-get ===
+ wget http://xo-get.olpc.at/xo-get.py
+ chmod u+x xo-get.py
+=== Update the xo-get repository database===
+ ./xo-get.py update
+=== Installation of xo-get GUI ===
+ ./xo-get.py install xo-get
+: Note: Joyride 1702, although it installed ok. When i click on the frame icon to run it. Flashes for awhile, then goes away. I ran it in terminal by  '''xo-get.py start xo-get''' and appears to run ok. (Filing some bugs and suggestions too. :) --[[User:Ixo|ixo]] 02:11, 17 February 2008 (EST)
+sugar-install-bundle/media/<usb stick name>
+=== Usage Examples ===
+'''List installed Activities'''
+ ./xo-get.py status
+'''Installing & Removing'''
+ ./xo-get.py install simcity
+ ./xo-get.py remove simcity
+'''Local .xo files'''
+ ./xo-get install simcity.xo
+ ./xo-get remove simcity.xo
+=== Name Assistant ===
+* Search, list, install and remove activities with typing only the beginning of the activity's/category's name as parameter
+List the category "Fun Games":
+ ./xo-get.py list fun
+Install CC Licensing Activity:
+ ./xo-get.py install cc
+Removing simcity
+ ./xo-get.py remove simc
 === GCompris ===
@@ Line 32: / Line 79: @@
  ./xo-get install gcompris
+== Repositories ==
+Newer versions of xo-get (>1.0) use a [http://xo-get.olpc.at/repository/ central repository] ([http://xo-get.olpc.at/repository/xoget.xml xml]), which is synced daily with the sub-'repositories'. Advantages of this structure are
+* 'xo-get update' will not break on changes in the repositories
+* supplying with filesizes and system-names (which sometimes differ from the wiki-names)
+* much less traffic on updates
+* backup repositories
+Repository Listing:
+# [[Activities]]
+# http://gcompris.net/incoming/xo/
+It's possible to add / change repositories on request ([[Xo-get#Contributors|mail]]). Also, any ideas for further developments are welcome!
+== Bugs / Issues ==
+Please file a ticket for any bug you find to the 'xo-get' component here: http://dev.laptop.org/newticket
+== Feature Request / Wishlist ==
+* [[Xo-get/Wishlist|Add an item]]
+{{:Xo-get/Wishlist}}
+== Changelog ==
+* 1.2.3: Switched to one [http://xo-get.olpc.at/repository/ central repository], lots of minor fixes
+== Contributors ==
+'''Author'''
+* [[User:Crazy-chris|Chris Hager]] (chris at linuxuser dot at)
+'''Testering'''
+* [[User:Jaume|Jaume Nualart]]
+* [[User:ixo|ixo]] - testering as much as I can. Submitted bug reports.
-=== Tips & Tricks ===
-* Search, list and install activities with typing only the beginning of the activity's/category's name as parameter
-List the category "Fun Games":
- ./xo-get.py list fun
-Install SimCity:
- ./xo-get.py install sim
+If you have ideas *and* some spare time: contact us! This project is open for anyone :-)
-=== Help Wanted ===
-* Anyone interested in developing a simple GTK interface? That would be so awesome! Please contact chris at olpc dot at
+[[Category:Activities]]
+[[Category:Developers]]
+[[Category:Resources]]
+[[Category:Package management]]
+[[Category:Activity installation]]
+<gallery>
-=== Screenshots ===
+Image:Example.jpg|Caption1
-<div style="border:2px solid grey; width:200px; float:left; margin-right:10px;">[[Image:Xo-get_install_done2.png|200px]]</div>
+Image:Example.jpg|Caption2
-<div style="border:2px solid grey; width:200px; float:left; margin-right:10px;">[[Image:Xo-get_install_xofile.png|200px]]</div>
+</gallery>
-<div style="border:2px solid grey; width:200px; float:left; margin-right:10px;">[[Image:Xo-get_remove_xofile.png|200px]]</div>