Welcome to Gentoox!
The original Xbox adaptation of Gentoo

· Home
· Buy_Gentoox
· Contact
· Dev_and_Sources
· Downloads
· Forums
· Links
· Magic_Repository
· Misc
· News Archive
· Patches
· Polls
· Search
· Sections
· Server_Stats
· Top 10
· Tutorials





Donors will be listed HERE!

Donations are handled by paypal.com

Hardware donations are also welcome, email me using the contact form!

     Latest Versions

     Powered by

Warning: preg_match(): Delimiter must not be alphanumeric or backslash in /mnt/big/www/shallax.com/htdocs/gentoox/includes/counter.php on line 41
Pro v5.0

(1718 total words in this text)
(7215 reads)   Printer Friendly Page

Gentoox Pro v5.0

  Copyright (C) Thomas "ShALLaX" Pedley (gentoox@shallax.com)

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA


 0.0 - Preamble
       0.1 - Whats new?
 1.0 - Installation tips
       1.1 - Necessary Configuration
       1.2 - Extra tweakables
 2.0 - Help, I'm still stuck!
       2.1 - Q&A
       2.2 - Known issues
 3.0 - Plans for the future
 4.0 - Thanks



This Linux distribution contains no copyrighted Microsoft code, no hacked
executables, no illegally compiled executables and no other illegal 
material to the best of my knowledge.  If anything is later discovered
to be illegal, when given reasonable proof, this distribution will be
taken out of circulation and destroyed and you must do the same.

This software comes with absolutely no warranty and I will not be held 
liable for anything bad that comes of using it.  I will not be held
responsible for any losses incurred from using this software.

This software has the potential of ruining all the data stored on your
Xbox including your TSOP or modchip.  You use this software and any 
subsequent software downloaded by this program at your own risk.

!                      AND IT DOES NOT HAVE A PREINSTALLED GUI                        !
!              INSTALLING A GUI SUCH AS KDE WILL TAKE AT LEAST 60 HOURS!              !

If the above warning alarms you, then you should be using Gentoox Home Edition.


0.0 - Preamble

Gentoox is a highly optimised and highly refined Linux distribution for the Xbox which 
receives regular updates.

Your Gentoox system comes with two predefined users, their details are as follows:

User: root
Pass: xbox

User: gentoox
Pass: xbox

The 'root' user is known as a superuser and has control over everything and everyone's
actions!  For this reason is it very important that you change your passwords as soon as 
you log in!.  To do this, open a console and type:

su -
[enter root password when asked]
passwd user_name

The "su -" command instructs Linux to (s)witch(u)sers to root and use root's system environment.

Once again, I refuse to accept responsibility for anything bad that may come of using this
software.  While I try my absolute best to ensure that this software is stable and fit for 
use, I make absolutely no guarantees that it is.  Use this totally at your own risk.  This 
software contains no hacked code or code built with the Microsoft Xbox SDK (XDK).

Throughout this readme you will see the term "xbox_ip", this is simply the IP address
assigned to your Xbox, e.g.

0.1 - Whats new?

* Updated software as of 06th-Jan-2009.
* Fully synced with magic as of 06th-Jan-2009.
* Kernel 2.4.37.
* Fixed profile to 2008.0.
* Fixed to work with Linux 2.4.
* Updated ALSA.
* Converted installer to use tbz2 rather than rar (non-free).
* Upgraded to Sparkle v4.0.

* Updated software as of 15th-Apr-2007.
* Fully synced with magic as of 15th-Apr-2007.
* Preinstalled netcat.
* Kernel with TCP Explicit Congestion Notification disabled as this 
  caused people issues
* Gentoox Loader v6.07.

* Updated software as of 21st-Aug-2006.
* Fully synced with magic as of 21st-Aug-2006.
* Latest baselayout fixes ugly rebooting.
* Updated the Stardust's raincoat to 0.11 (151 flash types).

* Fixed initrd to mount native partitions as read-only so as not to cause
  the checkroot script to break.

* Fixed Stardust to work with native installations properly.

* Gentoox Loader v6.05
* Updated software as of 26th-Jul-2006.
* Fully synced with magic as of 26th-Jul-2006.
* ReiserFS filesystem.
* Sparkle 3.0

* Gentoox Loader v6.04
* Updated software as of 02-Jul-2006.
* Fully synced with magic as of 02-Jul-2006.
* ext3 filesystem.
* Junk moved out of local.start and local.stop.
* checkroot/checkfs bug fixed.
* Sparkle 2.0 (now pretty much redundant as checkroot is fixed!)
* ALSA and kernel ebuilds made to be more compatible with Gentoo.
* Linux v2.4.32.

* Gentoox Loader v5.11.
* Fully synced with magic as of 12-Jun-2005.

* Gentoox Loader v5.9.
* Updated software as of 04-Jun-2005.
* Fully synced with magic as of 04-Jun-2005.
* Sparkle v1.5.
* Removed LED tutorials - its now part of the Loader.
* Switched to 2005.0/2.4 profile.
* Stardust is more friendly to v1.6 Xboxes with overscan.

* Switched to changelog style for this "Whats new?" section.
* Gentoox Loader v5.1a.
* Updated software as of 08-Jan-2005.
* Fully synced with magic as of 08-Jan-2005.
* Sparkle v1.4.

* Xcalibur (Xbox v1.6 support).


If you do not have DHCP, the following settings will be automatically assigned to you:


Of course, you can change these settings yourself by following the Network tutorial
on the site.


1.0 - Installation tips

None of this section applies for 'native' installs.  Do not attempt to run these commands if 
you have selected 'native' or you may damage your filesystem!  These commands have been known to
fail and may cause dataloss, use at your own risk!

If you later want to switch which partition Gentoox is installed to, you can do so with

Should you find yourself running out of space for Linux, you can either follow the
online tutorial on resizing your rootfs, or you can run the following command
to add more partitions (100-4000MB and as many as you can fit on F:)

magic newfs

1.1 - Necessary Configuration

You should run "xbvset" first thing to setup your video modes.  Follow the onscreen

1.2 - Extra tweakables

Once you've got your resolution selected, you'll notice your LED is green while running
and red while rebooting/ shutting down.  You can change the colour sequence/ pattern by
doing the following:

su -
[enter root password when asked]

Have fun with this, but follow the instructions ;)


2.0 - Help, I'm still stuck!

If you are having issues using the magic system, remember you can always run "magic usage"
(provided you have an internet connection).

Your most valuable resource regarding Gentoox is its homesite: http://gentoox.shallax.com
If you need some dynamic assistance, feel free to drop in to the official channel on irc:

Server : irc.shallax.com
Channel: #gentoox

( Windows mIRC users can run the following url: irc://irc.shallax.com/gentoox )

2.1 - Q&A

Q) Gentoox hangs whilst launching from EvoX...  What do I do?!
A) Turn off In-Game-Reset (IGR) from EvoX.  This needs to be disabled in ALL 3 places!
   This is a bug the EvoX team seem to have introduced in v1.8.3921.  They tell me this
   will be fixed in the next release.

Q) I cant see anything when I boot up, what can I do?
A) You can edit linuxboot.cfg, you should see this line


   Basically, you can change the resolution here, and the horizontal (hoc) and vertical (voc) 
   overscan correction.  Tested resolutions are 640x480, "hoc" and "voc" are specified as 
   percentages, (X and Y are defaults which are just ignored - they should work for everyone!).
   You can set these to hoc=10,voc=6, for example.  The default settings _should_ work for
   everyone!  XBV can be run on top of these settings should you wish to change your screen
   setup whilst linux is running.  

   The "nohwcursor" is what fixes the garbled cursor graphics.


2.2 - Known Issues

* Sometimes Gentoox Loader fails to decompress the background image correctly.
  You'll know when this happens as you'll end up with a black background with no
  icons.  Just boot as you would do normally.
* Focus only works in progressive scan mode for HDTV
* No proper v1.6 (Xcalibur) support - only basic 640x480 with no overscan 


3.0 - Plans for the future

No plans, as such.  Just keep things up to date.


4.0 - Thanks

Thanks goes out to everyone who has supported me, offered suggestions and criticised
(constructively!!!) my work.  You are the people who motivate me in my task to produce
(what I feel) is the best Xbox Linux distribution around!  Without you, I probably would
not have bothered going beyond the initial "FINAL" release (as the name would suggest,
I didn't plan on releasing any updates, hehehe!).

Thanks to all donators, without you I'd never have got all the hardware I needed to develop
Gentoox at a reasonable rate.

I'd also like to thank Xantium from Xbox-Scene for posting news relating to Gentoox.

Thanks to the Xbox-Linux team for Cromwell.

Thanks to dmp for his excellent skills at making useful applications and tweaks to

HUGE thanks to the creator of BusyBox - that is an amazing piece of work!  Also, thanks
to the creators of Slackware and Slothbox.

Thanks to Soundgarden, Audioslave, The White Stripes and The Raconteurs
for providing me with something to listen to :)

Special thanks to Halfbreed and Rickz0rz for the wallpapers.  Also
many thanks to everyone else who submitted wallpapers, even if they didn't make it in!
(Trogdor, Darkmotion, indi, fafnir, eentelf, janten, Dantax, mansen, Dmack_901, Yavin,
fuz, MikerhinosFR, Agent Orange, fuz, Anata, Rickz0rz and anyone else who I may have left off!).

Thanks to Hellimod, Pedro, Dave, Blake, tytyty, Disp, Byte, Xolution, Genlee, Pb,
def, wik, Ziekke, Coolberg, nitra, h3inrich, Rocketeer, xboxmastr, Bucko, paulproteus, Xenia,
bioterror, Turdhat, Jester, CyKiller, bikr, milkpost, Psylenced, TJ, Weezle, nath69uk,
kickass, madskillz, fuz, BeckyK, Iriez, choichoi, flow\23\, wrayal, frost, k3rn3l, hinkey,
Hadaken, iceslice, zao, localhost...

Thanks to Friendtech for their generous DreamX donation.  Thanks to Sinister Elf of
Xbox100.com for his Xbox v1.6 donation.

And THANKS to everyone else I've forgotten (Sorry!  Your help and support was much appreciated!)

Thanks to you for taking the time to read this instruction manual!

Remember - feedback is the only way I'll know when there is a problem

                - Thomas "ShALLaX" Pedley (gentoox@shallax.com)



[ Back to Versions | Sections Index ]

Gentoox is distributed under the terms of the General Public License

Page Generation: 0.02 Seconds