Xo-get: Difference between revisions

From OLPC
Jump to navigation Jump to search
m (how to install the gui)
 
(35 intermediate revisions by 19 users not shown)
Line 2: Line 2:
<tr>
<tr>
<td valign="top">__TOC__</td>
<td valign="top">__TOC__</td>
<td valign="top" style="padding-left:20px;">
<td valign="top" style="padding:10px 26px;">[[Image:activity-xoget.png]]</td>
<td valign="top" style="width:300px; text-align:center;">
'''XO-Get''' is a very simple package-installer / manager, used for installing, testing and removing activities for / on the xo-laptop and emulators.
'''<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.



'''News''':
We are currently working on a PyGTK [[Xo-get/Xo-get-gtk|Graphical User Interface for xo-get]] ([http://dev.laptop.org/git?p=projects/xo-get;a=blob;f=xoget.activity/xoget.xo alpha version]).
'''<font color="green">News</font>''': We are currently developing a [[Xo-get/Xo-get-gtk|Graphical User Interface]] with [[PyGTK]]</td>
</td>
</tr>
</tr>
</table>
</table>
Line 13: Line 13:


== About xo-get ==
== About xo-get ==
* [http://dev.laptop.org/git?p=projects/xo-get;a=blob;f=xo-get.py Source] (GPL)
* [http://www.olpc-europe.org/browse/xo-get.py xo-get.py] (GPL)
* [http://dev.laptop.org/git?p=projects/xo-get;a=tree dev.laptop.org]
* [http://dev.laptop.org/git?p=projects/xo-get;a=tree Source Tree]
* [http://xo-get.olpc.at/repository/ Activity Repositories]
* Repository: [[Activities]]
* [[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)




== Supported commands ==
./xo-get.py update
./xo-get.py update
./xo-get.py list ['categories' / category_name / 'gcompris']
./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 install activity_name / activity_file.xo
./xo-get.py remove activity_name / activity_file.xo / activity_directory
./xo-get.py remove activity_name / activity_file.xo / activity_directory
Line 30: Line 35:


: <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>
: <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 ==
== Usage ==
=== Installation of xo-get ===
=== Installation of xo-get ===
wget xo-get.olpc.at
wget http://xo-get.olpc.at/xo-get.py
chmod u+x xo-get.py
chmod u+x xo-get.py


=== Update the xo-get repository database===
./xo-get.py update


=== Installation of xo-get GUI ===
=== Installation of xo-get GUI ===
./xo-get.py install xo-get
./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 ===
=== Usage Examples ===
Line 53: Line 61:
./xo-get install simcity.xo
./xo-get install simcity.xo
./xo-get remove simcity.xo
./xo-get remove simcity.xo



=== Name Assistant ===
=== Name Assistant ===
Line 63: Line 70:
Removing simcity
Removing simcity
./xo-get.py remove simc
./xo-get.py remove simc



=== GCompris ===
=== GCompris ===
Line 73: Line 79:
./xo-get install gcompris
./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.


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




Line 78: Line 123:
[[Category:Developers]]
[[Category:Developers]]
[[Category:Resources]]
[[Category:Resources]]
[[Category:Software]]
[[Category:Package management]]
[[Category:Activity installation]]

<gallery>
Image:Example.jpg|Caption1
Image:Example.jpg|Caption2
</gallery>

Latest revision as of 18:11, 20 November 2011

Activity-xoget.png

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:

updateUpdates the Database
listLists installable Activities
searchSearches for tags, names, descriptions
installInstalls the given Activity
removeRemoves an Activity
startStarts Activity
statusList 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:

  1. Activities
  2. http://gcompris.net/incoming/xo/


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

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


Contributors

Author

Testering


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