X-Wrt
OpenWrt for end users |
Hosted at ...
|
X-Wrt is a set of packages and
patches to enhance the end user experience of OpenWrt. It is NOT a fork of OpenWrt.
We work in conjunction with the OpenWrt developers to extend
OpenWrt.
Our packages currently work with the
latest public release of OpenWrt - White Russian RC6. We also
maintain backwards compatibility with OpenWrt White Russian RC5.
Support of OpenWrt's upcoming Kamikaze firmware is
coming soon. Explore this page to learn
about our work, or just skip straight to
installing X-Wrt and
see the fruits of our labor yourself.
Project Links:
Document Navigation:
-
Introduction
-
Status
-
Installation
Instructions
- Webif2 Troubleshooting
- X-Wrt
Packages
- OpenWrt
Kamikaze Plans
-
Commercial Use: Ok
-
Participate
- Support Us
Introduction to
X-Wrt
X-Wrt was started because there was a
need for end user extensions to OpenWrt, such as an enhanced web
management console (webif). For a long time now it has been
established that OpenWrt is the best firmware in its class. It
far exceeds other firmwares in performance, stability,
extensibility, robustness, and design. We at X-Wrt decided it
was long past time for end users to get access to this superior
firmware.
We are a separate project from OpenWrt
due to the difference in focus and development ideals. We are
considerably more pragmatic than OpenWrt and have the goal of
providing solutions today, while OpenWrt has a more
idealistic development philosophy and intends to perfect the
firmware core, no matter how many rewrites and how much time it
takes. This difference in development attitude creates a
complimentary atmosphere that benefits everyone.
This is a free, open-source,
community-driven project. Our primary project ideals are:
- Free and open-source. The
project should be entirely free and open-source, licensed
under the GPL. The project should always be hosted at an
easily accessible site and source code readily available and
easily built.
- Easy entrance. The project
should always be open to new contributors and have a low
entrance barrier. Anyone should be able to contribute. We
actively grant write access to anyone interested in having
it. We believe people are responsible when given
responsibility. Just ask and we'll sign you up.
- Community driven. This isn't
about 'us' offering 'you' something, it's about everyone
coming together to work towards the common goal.
- No monetary donations without
accounting. The project can not accept monetary
donations without having a treasurer to hold and account for
all donations and what they have went towards.
Project Status
This project is still young, but we are accomplishing things at a rapid
pace. All our work is currently in beta, but our code can be used today and is
more stable than many firmwares in their 'final' state. You can keep up with the latest developments by checking the xwrt-svncheckins
message list that archives commit logs as they happen:
https://lists.berlios.de/pipermail/xwrt-svncheckins.
Our latest stable snapshot of webif2 is
Milestone 2. The
install buttons below will have you install it. If you then use the
webif's update feature you will get the latest internal build.
Installation
Instructions
X-Wrt is a set of packages that overlay OpenWrt. There are two primary ways to
install and use X-Wrt on your router:
- Flash OpenWrt White Russian, then install webif2 and any
other X-Wrt packages.
...or...
- Flash a pre-built image of OpenWrt White Russian that
already includes X-Wrt packages like webif2.
- Method #1:
Flash OpenWrt White Russian then
install X-Wrt packages
- If you do not already have OpenWrt White
Russian on your router, download an appropriate OpenWrt White Russian image and flash it
(follow instructions in OpenWrt's wiki). We recommend
White Russian RC5, RC6, or 0.9 (when it is released). Kamikaze is NOT supported yet,
but will be soon.
- Enter your router's IP address in the field below and click the
button below to install the latest official beta release of X-Wrt's webif.
After you install the latest official beta release the 'check for
update' and 'upgrade' buttons you'll find in the webif itself will
move you up to the latest daily build, which has more features but
has been less extensively tested.
This button will NOT work with Internet Explorer at present.
If the display of the web pages looks funny, do a
hard refresh (hold down SHIFT and click REFRESH) to clear out the old
CSS.
Instead of using this automated install procedure, you can also ssh
or telnet to the router and run ...
(latest milestone): ipkg install
http://ftp.berlios.de/pub/xwrt/packages/webif_milestone2.ipk
(latest daily): ipkg install
http://ftp.berlios.de/pub/xwrt/webif_latest.ipk
- Method #2:
Flash pre-built OpenWrt White Russian images
- Download firmware images from here:
ftp://ftp.berlios.de/pub/xwrt/images/
. Download the one appropriate to your router.
- Once you've extracted the images, flash the squashfs
image appropriate to your router by following the
instructions on OpenWrt's wiki.
Micro builds are currently under development and will be
posted as soon as they are ready.
WARNING: These images are in a non-final
state and are updated several times a week. Although they
should be stable, if you have any troubles with them, please
report it.
Webif2 Problems
Since our new webif is in beta sometimes you can get a build
that has problems. The best advice is:
- Upgrade to a newer build when it is available.
-
Report bugs or other errata you see if you don't find it
fixed in the next build. It's hard for us to test every
build thoroughly.
- If you somehow got unlucky and ended up with a daily
build that was horribly broken and you can't upgrade the
webif, ssh into the router and run this:
ipkg install
http://ftp.berlios.de/pub/xwrt/webif_latest.ipk
-force-reinstall
X-Wrt Packages
Although all our work is based around our webif2 package, we
actually have a number of packages to add to OpenWrt. At present
they are all for White Russian, but we are moving actively into
Kamikaze right now. A list of some of our packages are:
- webif2 - our new webif, but you already know
that ;).
- miniupnpd - an offering of this excellent new
upnp daemon.
- tarfs - a specialized pseudo-filesystem for micro
sized routers. - alpha stage development
- busybox 1.2.1 - an update over the Busybox 1.0
used in White Russian. It also includes some different
applets, like user management utilities.
- wireless-tools v29 pre10 - an update to
wireless-tools (iwconfig, iwlist, etc..).
- ipkg-upgrade-fix - issues a warning when a user
tries to run 'ipkg upgrade', something known to wreak havoc
on unsuspecting users.
OpenWrt Kamikaze Plans
We are working actively towards a version of the webif for
OpenWrt's long delayed next generation, Kamikaze. By the time
Kamikaze goes public, we probably will have finished support for
it.
OpenWrt Kamikaze represents a substantial and fundamental
change. It is not simply a new version of White Russian, but
instead a complete rewrite of the build root and configuration
structure. That is why White Russian went stagnant for so long,
the developers quit working on it in favor of this more
ambitious idealized solution. This new branch of OpenWrt took a
long, long time to hash out, but now its almost ready.
The ever-popular NVRAM configuration storage system is no
longer utilized in Kamikaze. It has been replaced with
configuration files, many stored in the common format known as
'UCI'. This was done because although an emulated NVRAM storage
area to keep tuple based configuration data can be easily
implemented on any platform, the OpenWrt developers felt it
wasn't structured enough for their tastes. So, out the window it
went.
To make the webif work with Kamikaze we therefore have to
work with this new configuration system. The good news is our
webif already supports UCI. Some pages, like the QoS page, use
the UCI system entirely. To finalize support for Kamikaze we
simply have to take the remaining code that utilizes NVRAM and
either write new code or write a translation layer to convert
NVRAM to and from UCI configuration files. The end solution may
be a combination of both.
While some developers not approve of us maintaining support for White
Russian, usually because they don't want to make the extra
effort, we believe it is important to continue to support the
only stable branch of OpenWrt released at the time of this
writing. White Russian will be around for many years and the
overhead required in supporting both Kamikaze and White Russian
is minimal compared to the rewards.
We hope to have basic Kamikaze support by the end of 2006.
Can I use X-Wrt
in my commercial venture?
Yes, you can use X-Wrt in whatever way
you like, providing you do not violate the terms of the GPL
license agreement and any other licenses applicable. We can help
you to rebrand the webif and tweak it to suit your needs. Some
of our developers do contract work. If you are interested in
using X-Wrt as part of a commercial venture, we'd love to hear
about it. Email us at
jeremy@bitsum.com to let
us know what you are using X-Wrt for, or to inquire about webif
related work.
Participate in X-Wrt
We always need developers, testers, documentation writers,
translators, and support personnel. Our project is truly OPEN and
FREE. Anyone can come join our project.
If you would like to get write access to our repository, just
create an account at www.berlios.de
and email jeremy@bitsum.com
or contact one of our other developers on the irc channel (#x-wrt /
freenode). We do not make anyone pass an 'entrance exam', though we
do like for people to supply a patch of some sort just to prove that
you are serious.
A listing of some of the needs we have are:
- development
- graphic artists
- localization (translation)
- user support
- documentation writers
Support X-Wrt
We do not accept monetary donations
because we have no project treasurer to account for those
donations and where they go. However, there are some things you
can help us with if you choose:
- web hosting. Berlios
provides most our web services, but we may need other web
hosts in the future.
- hardware donations. You can
donate routers or other hardware to our developers, who may
be in need of them for testing purposes. We are currently
running our poor routers into the ground, so we encourage
these type of donations.
- spread the word. Tell people
you think might be interested about our project. Not even
all OpenWrt users have heard of our project yet. You might
consider mentioning X-Wrt on the OpenWrt forums and in
#openwrt on freenode.
|