Tomahawk Computers

Microsoft Windows and Tomahawk Desktop dual boot?
NOTE: This procedure requires some technical knowledge in Linux. If you are not a Linux techie, please get assistance from somebody who is conversant with Linux.

a) Repartition your computer

One way to do this is, boot your computer from the Tomahawk Desktop DVD and use cfdisk to partition.

Example:
partition1 Windows [Size of your choice]
partition2 /boot [Size: min 50MB]
partition3 /usr [Size of your choice, min 6GB]
partition5 /home [Size of your choice]
partition6 /tmp [Size: min 1GB]
partition7 / [Size: min 1GB]
partition8 Swap [Size: min 512MB]
partition9 /var [Size of your choice, min 1GB]

NOTE: Be aware that the BIOS in some old computers cannot access more than the first 1024 cylinders on a hard disk. If this is the case, the /boot partition must be located on the first 1024 cylinders of your hard disk to boot Tomahawk Desktop.

b) Install Windows

NOTE 1: Make sure Windows is installed on the first partition.

NOTE 2: If you want to be able to read from and write to a Windows NT, 2000, or XP partition from Tomahawk Desktop, do not set the Windows partition to file system type NTFS.

Restart your computer and make sure you can start your from Microsoft Windows without an issue.

c) Install Tomahawk Desktop

1) Boot your computer from the Tomahawk Desktop DVD.

2) vi /etc/sysconfig/network-devices/ifconfig.eth0/eth0 and set your network parameters.

3) Run /etc/sysconfig/network-devices/ifup eth0

4) cd /root

5) wget http://www.tomahawkcomputers.com/download/TomahawkInstall-WDB

6) Check md5sum
md5sum TomahawkInstall-WDB

It should be 5a2a46e3d95dcd79099e2aaa76272aba

7) chmod +x TomahawkInstall-WDB

8) ./TomahawkInstall-WDB

Do not select auto partitioning, Use partitions created.

2. Users Management

How do I change the super user password?
a) Login to Tomahawk Desktop as the root user. Super user userid is root and initially the password is root.

b) Click on K Menu (bottom-left corner)->System->KUser (User Manager). This is what you should see.

c) Double click on the root user line.

d) Click on the Set Password tab.

How do I add normal users?
a) Login to Tomahawk Desktop as the root user.

b) Click on K Menu (bottom-left corner)->System->KUser (User Manager). This is what you should see.

c) Click on the ADD tab.

d) Type the username and press Enter.

e) Now you are on the User Properties window. Click on the Set Password tab and set the new user's password.

f) Click on the Groups tab. Tick following groups:
audio    Click here to see a screenshot.
disk     Click here to see a screenshot.
users    Click here to see a screenshot.

g) Click on OK tab to add the user to the system.

h) After adding all users, Click on K Menu (bottom-left corner), Log Out and log in as a normal user.

Never ever browse Internet while login as the root user.

How many normal users can I add?
No upper limit.

3. Audio Queries

No sound, why?
Sound is disabled by default.

How do I enable sound?
a) Click on K Menu (bottom-left corner)->Control Center->Sound & Multimedia->Sound System. Disable the KDE sound system to avoid ALSA conflicts. This is what you should see after disabling the KDE sound system.

b) Click on K Menu (bottom-left corner)->Multimedia->KMix (Sound Mixer). This is what you should see.

Adjust the Master volume, enable PCM and increase PCM value. Enable and adjust the PC Speaker volume if you are on a laptop. Now close the KMix window.

c) Now there should be a crossed speaker icon on the bottom-right corner of the KDE Panel. Right click on it and enable it.

What is the version of ALSA library used in Tomahawk Desktop 1.1?
1.0.8

What sound cards/chipsets compatible with Tomahawk Desktop?
Sound cards/chipsets compatible with ALSA 1.0.8.

What configurations do I have to make before use Xmms?
Right click on top portion of Xmms->Options->Preferences->Options and enable Use realtime priority when available. Apply new settings, close and relaunch Xmms.

What configurations do I have to make before use amaroK?
Go to Settings->Configure amaroK->Engine

Change Sound System to GStreamer Engine
If GStreamer Engine doesn't work for you, change it to Xine Engine.

Change Output plugin to alsasink
If alsasink doesn't work for you, change it to osssink.

Save settings, click on Actions at top-left corner and click on Quit. Relauch amaroK.

What configurations do I have to make before use juK?
Go to Settings->Output To
Change to GStreamer

How to play an audio CD?
a) Insert your audio CD.

b) Close or Cancel this pop up.

c) Play with either Xmms or amaroK.
In Xmms, your audio CD is available under /mnt/audiocd/

4. Video Queries

What configurations do I have to make before use Xine?
a) Do this only if you get a blue Xine window and no video:
Right click on the main Xine window->Settings->Setup->video
Change video driver to use to xshm.

b) Click on media tab
Check the region the DVD player claims to be in (1 to 8)

c) Type /dev/dvd to the device used for DVD playback under media tab.

d) Type /dev/dvd to the device used for VCD playback under media tab.

e) Apply settings, close Xine and relaunch Xine.

What configurations do I have to make before use VideoLAN?
a) Do this only if no video and VideoLAN exists when attempts play:
Settings->Preferences->Video->Output modules

Tick Advance options on botton-right.
Change video output module to X11 video output.

b) Settings->Preferences->Input/Codecs->General
Tick Advance options on botton-right.
Set DVD device to /dev/dvd
Set VCD device to /dev/cdrom
Set Audio CD device to /dev/cdrom

c) Apply settings, close VideoLAN and relaunch VideoLAN.

How to play a VCD/DVD?
a) Insert your VCD/DVD.

b) Close or Cancel this pop up.

c) Play with either Xine, VideoLAN or MPlayer

5. Media Access

How do I access a data CD/DVD?
a) Insert your CD/DVD.

b) Close or Cancel this pop up.

c) Click on the Home icon on the KDE Panel to launch the Konqueror file browser and click on its Up arrow icon and go to /mnt/cdrom. You can see contents of the CD/DVD now.

If cdrom folder not available under /mnt, please wait till your CD/DVD drive to settle and click the refresh icon on the Konqueror file browser. Same data is available under /media/cdrom, you can refer to either folder.

d) Now any application can refer your CD/DVD as if it is part of your file system. You can now drag and drop these files to applications .

e) Once you are done, close the Konqueror file browser window that refers to your CD/DVD. Close all other applications open files on your CD/DVD. Wait for minumum 2 seconds after closing the last application refered to your CD/DVD to complete house keeping.

f) Press the Eject button on your CD/DVD to eject it.

How do I access a Thumbdrive?
a) Insert your Thumbdrive to a USB port.

Note: if you did not introduce the Thumdrive to the Tomahawk Desktop, please introduce it as per instructions below.

b) Close or Cancel this pop up.

c) Click on the Home icon on the KDE Panel to launch the Konqueror file browser and click on its Up arrow icon and go to /mnt/thumbdrive. You can see contents of the Thumbdrive now.

If you insert a second Thumbdrive, its available under /mnt/thumbdrive1. Tomahawk Desktop supports upto 4 Thumbdrives connected to it at the same time. The fourth Thumbdrive is available under /mnt/thumbdrive3.

If thumbdrive folder not available under /mnt, please wait till your Thumbdrive to settle and click the refresh icon on the Konqueror file browser. Same data is available under /media/thumbdrive, you can refer to either folder.

d) Now any application can refer to your Thumbdrive as if it is part of your file system. You can now drag and drop files to applications or to the Thumbdrive. You can copy data between Thumbdrives without copying to your computer, just drag and drop from one Thumbdrive to another.

e) Once you are done, close the Konqueror file browser window that refers to your Thumbdrive. Close all other applications open files on your Thumbdrive. Wait for minumum 2 seconds after closing the last application refered to your Thumbdrive to complete house keeping.

f) Now you can physically remove the Thumbdrive.

If you did not close all applications refer to your Thumbdrive before physical removal , you risk data corruption.

How do I introduce a Thumbdrive to Tomahawk Desktop?
a) Insert your Thumbdrive to a USB port.

b) Close or Cancel this pop up.

c) Open a Konsole. Click Konsole button on the KDE Panel to open a Konsole.

d) su and login as root.

e) Run addThumbDrive to introduce the Thumbdrive to Tomahawk Desktop. The addThumbDrive will now show your Thumbdrive's brand and model. In case, if its doesn't show, you have to wait for a while and rerun addThumbDrive. If it still doesn't show, may be the Thumbdrive is not plug in properly, remove the Thumbdrive, reattach and rerun addThumbDrive. If it still doesn't show, may be your USB port is faulty, plugin the Thumbdrive to a different USB port.

f) After the addThumbDrive is completed, physically remove the Thumbdrive and reattach.

Introducing the Thumbdrive to Tomahawk Desktop is required to perform only once, but if need to use a Thumbdrive of different brand or model, you need to introduce the new Thumdrive to the Tomahawk Desktop.

How do I access a Digital Camera?
a) Insert your Digital Camera to a USB port.

Note: if you did not introduce the Digital Camera to the Tomahawk Desktop, please introduce it as per instructions below.

b) Close or Cancel this pop up.

c) Click on the Home icon on the KDE Panel to launch the Konqueror file browser and click on its Up arrow icon and go to /mnt/camera. You can see contents of the Digital Camera now.

If you insert a second Digital Camera, its available under /mnt/camera1. Tomahawk Desktop supports upto 4 Digital Cameras connected to it at the same time. The fourth Digital Camera is available under /mnt/camera3.

If camera folder not available under /mnt, please wait till your Digital Camera to settle and click the refresh icon on the Konqueror file browser. Same data is available under /media/camera, you can refer to either folder.

d) Now any application can refer to your Digital Camera as if it is part of your file system. You can now drag and drop image files to applications.

e) Once you are done, close the Konqueror file browser window that refers to your Digital Camera. Close all other applications open files on your Digital Camera. Wait for minumum 2 seconds after closing the last application refered to your Digital Camera to complete house keeping.

f) Now you can physically remove the Digital Camera.

NOTE: Deleting image files from the Konqueror window, physically removes images from the camera.

If you did not close all applications refer to your Digital Camera before physical removal , you risk data corruption.

How do I introduce a Digital Camera to Tomahawk Desktop?
a) Insert your Digital Camera to a USB port.

b) Close or Cancel this pop up.

c) Open a Konsole. Click Konsole button on the KDE Panel to open a Konsole.

d) su and login as root.

e) Run addCamera to introduce the Digital Camera to Tomahawk Desktop. The addCamera will now show your Digital Camera's brand and model. In case, if its doesn't show, you have to wait for a while and rerun addCamera. If it still doesn't show, may be the Digital Camera is not plug in properly, remove the Digital Camera, reattach and rerun addCamera. If it still doesn't show, may be your USB port is faulty, plugin the Digital Camera to a different USB port.

f) After the addCamera is completed, physically remove the Digital Camera and reattach.

Introducing the Digital Camera to Tomahawk Desktop is required to perform only once, but if need to use a Digital Camera of different brand or model, you need to introduce the new Digital Camera to the Tomahawk Desktop.

How do I access an Ipod?

Please follow this First-time Configuration:

NOTE: If you have already done this under MP3 Player, you don't have to do it again this First-time Configuration.

1. Click Konsole button on the KDE Panel to open a Konsole.
2. Type su and press Enter and login as root.
3. Copy and paste following line to Konsole and press Enter.

cd /usr/share/hal/fdi/information/10freedesktop/

4. Copy and paste following line to Konsole and press Enter.

mv 10-usb-music-players.fdi 10-usb-music-players.fdi.ORIG

5. Copy and paste following line to Konsole and press Enter.

touch 10-usb-music-players.fdi

6. Type exit and press Enter, Type exit and press Enter again to quit Konsole.

Note: Please bear up with this First-time Configuration issue, an upgrade in Tomahawk Desktop 1.1 has broken the seamless Ipod access and it will be fixed in our next version.

a) Insert your Ipod to a USB port.

b) Close or Cancel this pop up.

c) Click on the Ipod icon on the Desktop to launch the gtkpod application. Click on to the Read button on the top left corner of the gtkpod. You can see contents of the Ipod now.

Files button is to add files to the Ipod.

Important: After you add or remove music files, you need to click on the Sync button to update the Ipod.

d) After the Sync is completed, close the gtkpod. Wait for minimum 2 seconds to complete necessary house keeping. You can now physically remove the Ipod.

How do I access a MP3 Player?

Please follow this First-time Configuration:

NOTE: If you have already done this under Ipod, you don't have to do it again this First-time Configuration.

1. Click Konsole button on the KDE Panel to open a Konsole.
2. Type su and press Enter and login as root.
3. Copy and paste following line to Konsole and press Enter.

cd /usr/share/hal/fdi/information/10freedesktop/

4. Copy and paste following line to Konsole and press Enter.

mv 10-usb-music-players.fdi 10-usb-music-players.fdi.ORIG

5. Copy and paste following line to Konsole and press Enter.

touch 10-usb-music-players.fdi

6. Type exit and press Enter, Type exit and press Enter again to quit Konsole.

Note: Please bear up with this First-time Configuration issue, an upgrade in Tomahawk Desktop 1.1 has broken the seamless MP3 player access and it will be fixed in our next version.

a) Insert your MP3 Player to a USB port.

Note: If you did not introduce the MP3 Player to the Tomahawk Desktop, please introduce it as per instructions below.

b) Close or Cancel this pop up.

c) Click on the Home icon on the KDE Panel to launch the Konqueror file browser and click on its Up arrow icon and go to /mnt/audioplayer. You can see contents of the MP3 Player now.

If you insert a second MP3 Player, its available under /mnt/audioplayer1. Tomahawk Desktop supports upto 4 MP3 Players connected to it at the same time. The fourth MP3 Player is available under /mnt/audioplayer3.

If audioplayer folder not available under /mnt, please wait till your MP3 Player to settle and click the refresh icon on the Konqueror file browser. Same data is available under /media/audioplayer, you can refer to either folder.

d) Now any application can refer to your MP3 Player as if it is part of your file system. You can now drag and drop files to music players such as Xmms or back to the MP3 Player. You can copy data between MP3 Players without copying to your computer, just drag and drop from one MP3 Player to another.

e) Once you are done, close the Konqueror file browser window that refers to your MP3 Player. Close all other music players open files on your MP3 Player. Wait for minumum 2 seconds after closing the last application refered to your MP3 Player to complete house keeping.

f) Now you can physically remove the MP3 Player.

NOTE: Deleting files from the Konqueror window, physically removes files from the MP3 Player.

If you did not close all applications refer to your MP3 Player before physical removal , you risk data corruption.

How do I introduce a MP3 Player to Tomahawk Desktop?
a) Insert your MP3 Player to a USB port.

b) Close or Cancel this pop up.

c) Click Konsole button on the KDE Panel to open a Konsole.

d) su and login as root.

e) Run addAudioPlayer to introduce the MP3 Player to Tomahawk Desktop. The addAudioPlayer will now show your MP3 Player's brand and model. In case, if its doesn't show, you have to wait for a while and rerun addAudioPlayer. If it still doesn't show, may be the MP3 Player is not plug in properly, remove the MP3 Player, reattach and rerun addAudioPlayer. If it still doesn't show, may be your USB port is faulty, plugin the MP3 Player to a different USB port.

f) After the addAudioPlayer is completed, physically remove the MP3 Player and reattach.

Introducing the MP3 Player to Tomahawk Desktop is required to perform only once, but if need to use a MP3 Player of different brand or model, you need to introduce the new MP3 Player to the Tomahawk Desktop.

6. Desktop Configurations

How do I enable the Mac OS X style dock?
Click on the K button -> utilities -> KXDocker.

How do I hide the KDE panel?
a) Right click on KDE Panel -> Configure Panel

b) Click on one of the top three buttons under Position.

c) Click on the Hiding tab.

d) Click on Hide automatically radio button and decrease the seconds until Immediately appears.

e) Click on Apply button to apply the settings and finally click on the OK button.

Note: To see the KDE Panel, roll the mouse over to the top of the desktop.

How do I add icons to Mac OS X style dock?
a) Open/run your application you need to add. Eg. If you need to add the Firefox browser, launch the Firefox browser first. Wait till it adds an icon to the KXDocker.

b) Roll the mouse over to the top of the desktop, now the KDE Panel appears. Right click on the KXDocker icon at the right end of the KDE Panel. Now a window pops up. Title is KXDocker.

c) Click on the Configurator.

d) Click on the Objects tab.

e) Click on the lower magic wand button. Now a new object is added to the objects list. The Info tab should be highlighted now. Fill in the Name, Group (if a similar group name is already given, give it a unique name. eg. browser2) and Over Text shadowed.

f) Click on Images tab and click again on the empty image icon. This opens up a window to select an icon. The icon size should be 128x128 pixels. If the icon size is smaller, it appears on the dock blur when enlarged. You may point to any png file.

g) Click on Actions tab and type the program name.

onClickExec: progName
onDropExec : progName "%1"

h) Click on Tasks tab and click again on the window with a yellow star icon. This adds couple of lines to tasks window. Delete unwanted lines by clicking on the red icon with a cross.

i) Click on Apply tab, which is on the left side of magic wand.

j) Click on Save button, which is indicated by a diskette.

k) Now close the KXDocker configuration window.

l) Right click on the KXDocker icon at the right end of the KDE Panel, click on Quit the KXDocker.

m) Relaunch the KXDocker.

NOTE: You may change the position of an icon on the dock by clicking the Up/Down arrows under the KXDocker Objects tab.

How do I remove icons from Mac OS X style dock?
a) Roll the mouse over to the top of the desktop, now the KDE Panel appears. Right click on the KXDocker icon at the right end of the KDE Panel. Now a window pops up. Title is KXDocker.

b) Click on the Configurator.

c) If your icon is an Object, remove it from Objects tab.

If your icon is an Alias, disable it. To disable, click on the Alias tab, select the item, change the className to disabled.

d) Save settings.

e) Right click on the KXDocker icon at the right end of the KDE Panel, click on Quit the KXDocker.

f) Relaunch the KXDocker.

How do I get Mac OS X style window decorations?
a) Click on K button -> Control Center -> Appearance & Themes -> Style. Change the Widget Style to Baghira.

b) Click on the Configure and make settings to your preference.

c) Click on the Apply to apply settings.

d) Click on K button -> Control Center -> Appearance & Themes -> Window Decorations. Select Window Decorations to Baghira.

e) Click on the Apply to apply settings.

How do I remove all icons from desktop?
a) Encircle all icons on the desktop using the mouse and press Delete button.

How do I restore all icons to the desktop?
a) Open a Konsole terminal window.

b) Type TomahawkSetup and press Enter.

7. Package Management

What is the Package Management System used in Tomahawk Desktop?
Click here to know more.

How do I install a new package?
a) Open a Konsole terminal window.

b) su and login as root.

c) Type following and press Enter to create the package user.

install_package 'Package Description' packageName packageName

NOTE: No colons in the Package Description. This description is the description field in /etc/passwd file.

Eg. To install Gizmo SIP Phone

install_package 'Gizmo SIP Phone' gizmo gizmo

Now its creates a new package user named gizmo, switches to the gizmo package user and changes the working directory to the home directory of the gizmo package user (/usr/src/gizmo/).

d) Install the new package.

e) Check the installation messages, if you find you cannot install files into some directory, make it an install directory as follows and rerun the installation:

chgrp install /path/dir/ && chmod g+w,o+t /path/dir/

f) Type exit. Now you are back to the root.

g) You may now run finalization programs such as /sbin/ldconfig etc. if necessary.

How do I list contents of a package?
a) Open a Konsole terminal window.

b) Type following and press Enter

list_package packageName

NOTE: Before you run list_package, make sure the Konsole Settings->History set to Unlimited. This may takes some time if you are running it for the first time as it scans the file system.

How do I remove a package?
a) Open a Konsole terminal window.

b) su and login as root.

b) su packageName and switch to the package user.

c) Type following and press Enter

uninstall_package packageName

NOTE1: Running uninstall_package does not remove anything but it shows some information and the real command to remove files of the package. You may list and see what files get removed just by running the forall_direntries_from as shown. To physically remove files, you need to run the forall_direntries_from command without the echo.

NOTE2: This may takes some time if you are running it for the first time as it scans the file system.

d) List the package contents to see whether all files belongs to the package properly removed. If it still shows there are files belongs to the package, those files may be installed as setuid-root. Remove them individually as root may be using another Konsole.

How do I make a distributable tar.gz of a package?
a) Open a Konsole terminal window.

b) Type following and press Enter

forall_direntries_from packageName -fprint0 packageName.lst

tar --no-recursion --null -czpf packageName.tar.gz --files-from=packageName.lst

How do I find names of already installed packages?
a) List the /usr/src/ directory. Except the bootscripts/ directory and linux-2.6.11.9/ directory, all other directory names are package user names. To see package user descriptions and other info, you may refer to /etc/passwd file.

How do I find version numbers of installed packages?
Click here.

8. Network Access

What is the default network access mode in Tomahawk Desktop?
It is Dynamic IP-Wired as the default network access mode if your computer is a desktop system or Dynamic IP-Wireless if you have a laptop.

That is, when you connect your desktop computer to a network switch/hub using a network cable and reboot your computer, Tomahawk Desktop requests an IP address and other network details from the DHCP server and automatically configure itself. Similarly, if it is a laptop, Tomahawk Desktop requests an IP address and other network details from the DHCP server and automatically configure itself. Therefore, you do not have to change any network setting in the Tomahawk Desktop, just start accessing the network.

If you need to assign a permanent IP address to your network card, switch network accessing from wired to wireless, etc. you need to change the network access mode.

How do I change the network access mode?
a) Click Konsole button on the KDE Panel to open a Konsole.

b) Type su and press Enter and login as root.

c) Type switchNetMode and press Enter.

How do I change the wireless network settings?
a) Click on K button -> Internet -> More Applications -> KWiFIManager.

How do I get the wireless network status indicator to the KDE Panel?
a) Click on K button -> Internet -> More Applications -> KWiFIManager -> Settings -> Stay in System Tray on Close.

9. Display

How do I change the display resolution?
a) Click Konsole button on the KDE Panel to open a Konsole.

b) Type su and press Enter and login as root.

c) Type regenXorgconfin and press Enter.

d) Once regenXorgconfin is completed, restart the computer.

I cannot get the correct display resolution, why?
The reason you don't get the display resolution you want even after you specify it to the Tomahawk Desktop is, either your graphic chipset/graphic card doesn't support that resolution or the graphic driver involved doesn't support that resolution.

You may download the latest driver for your graphic hardware from the manufacture (eg. Nvidia, ATI, etc) and install.

To resolve the graphic hardware issue, the video BIOS of your graphic chipset/graphic card could be reprogrammed to support the resolution you want.

If your graphic chipset is 800 or 900 series Intel graphics chipset, click here to learn how to update the video BIOS.

For other graphic chipsets, ideally check with the graphic chipset manufacturer.

If you still cannot get the correct display resolution, you may change your graphic chipset/graphic card. IMPORTANT: Before you do this, please refer to what is the proper procedure to change the graphic card?.

what is the proper procedure to change the graphic card?
a) Login to Tomahawk Desktop as root.

b) Use your preferred text editor (eg. Kate) and open the /etc/inittab file.

c) Go to the following line:

id:5:initdefault:

d) Change 5 to 3, and now it should look like as follows:

id:3:initdefault:

e) Save the file and shutdown the computer.

f) Open the computer and change your graphic card. Once you are done, switch on the computer.

g) Once computer is started, now it goes directly into a text-based login prompt. Please note, it doesn't show the graphical login screen.

h) Type root and login as root.

i) Type regenXorgconfin and press Enter.

j) Once regenXorgconfin is completed, restart the computer.

k) Type root and login again as root.

l) Type init 5 and press Enter.

m) Now you should get a graphical login screen. If you don't get, Type init 3 and press Enter and follow again from step i).

n) Type root and login again as root.

o) Use your preferred text editor (eg. Kate) and open the /etc/inittab file.

p) Go to the following line:

id:3:initdefault:

q) Change 3 to 5, and now it should look like as follows:

id:5:initdefault:

r) Save the file, close the text editor, logout and login again as you (normal user).

NOTE: If you cannot get the graphical screen after following this procedure, you may need to install a driver from the graphic card manufacturer. Please follow Nvidia or ATI driver installation procedure as a guidance.

Where do I make Xorg settings?
In Tomahawk Desktop, /etc/X11/xorg.conf is auto regenerated (if necessary) at boot up time after checking hardware. This is to include hardware information it finds in the /etc/X11/xorg.conf without any human intervention. Therefore, do not edit /etc/X11/xorg.conf directly.

The /etc/X11/xorg.conf.in is used as a template for this process. You may place your values in /etc/X11/xorg.conf.in. If you edit /etc/X11/xorg.conf.in, then delete the /etc/X11/xorg.conf and restart the computer.

When you run regenXorgconfin, it regenerates the /etc/X11/xorg.conf.in, the /etc/X11/xorg.conf.in.template is use as a template for this process.

The regenXorgconfin is useful if you change your graphic card (eg. Matrox to Nvidia) and need to regenerate the xorg.conf without manually editing anything.

10. Media Streaming

How do I Enable/Disable the Icecast Media Streaming server?
a) Click Konsole button on the KDE Panel to open a Konsole.

b) Type su and press Enter and login as root.

c) To enable Icecast server type enableIcecast and press Enter. This sets the Icecast server to start at every system boot up. If you do not want to reboot to start the Icecast server, you may run following as root: /etc/rc.d/init.d/icecast start

To disable Icecast server type disableIcecast and press Enter. This sets the Icecast server not to start at system boot up. If you do not want to reboot to stop the Icecast server, you may run following as root: /etc/rc.d/init.d/icecast stop.

d) Restart the computer is optional if you manually start or stop the Icecast server, otherwise, Restart the computer.

How do I stream MP3?
a) Make sure the Icecast server is started. Please refer to How do I Enable/Disable the Icecast Media Streaming server?

b) Click on the K button -> Multimedia -> MuSe (Broadcast Audio).

c) Click on the Vumeters button. This will pop out a small window with VU meters.

d) Click on the Lets Stream! Button on the top left corner of the MuSe, and then it will pop out the Add Server settings window, click on the I'm Expert button.

e) Set the Quality bar to High, Mode to Stereo, bitrate to 128, frequency to 44100 and click on the Apply.

login Type should be icecast2, password is hackme, now click on the Connect button. If the password is correct, it shows in the MuSe window bottom that it is now streaming.

f) Now right click on the white area on the middle of the MuSe window and add MP3 files. Select also how you want your MP3 files to be played, eg. single play, loop or continuous.

g) Select the first MP3 file (or of your choice) and click on the play icon. That's it.

h) To listen to your MP3 broadcast, on another computer, open a MP3 player and type following url:

http://<IP Address of the streaming computer>:8000/live

If the listening computer is another Tomahawk Desktop:

On Xmms

Right click on Xmms->Play Location and type
http://<Streaming Computer hostname>.local:8000/live
Eg. http://grey.local:8000/live

On amaroK

Click on Playlists tab->Right click on the Radio Streams and add as a new radio stream
http://<IP Address of the streaming computer>:8000/live

i) Please edit the /etc/icecast.xml file to change password, port, mount point, etc. Refer to Icecast project for more info.

How do I stream video?
a) Put a DVD or VCD in. If you play a file from hard disk, skip this step.

b) Click on the VideoLAN icon on the desktop. If you have not configured the VideoLAN, please refer to Video Queries to learn how to configure.

c) On VideoLAN, Click on the File->Open Disk.

d) Enable Stream output by ticking it and Enable Caching and increase caching (eg. 3000).

e) Now click on the Settings tab for Stream output.

f) Enable Play locally under Output methods.

g) Enable HTTP under Output methods, change the port to 8080 and click OK.

h) click OK again to play the DVD. Now you must be able see the DVD playback.

i) To listen to your video broadcast, on another computer, open a video player and type following url:

http://<IP Address of the streaming computer>:8080

If the listening computer is another Tomahawk Desktop:

On VideoLAN

File->Open network Stream, select HTTP and type
<IP Address of the streaming computer>:8080

Enable and increase the caching.

NOTE: You may replace the IP address with hostname.local if your video player support it.

11. Web Server

What's the name of the web server included into Tomahawk Desktop?
Apache. Click here to learn more info.

How do I enable/disable the web server?
a) Click Konsole button on the KDE Panel to open a Konsole.

b) Type su and press Enter and login as root.

c) To enable web server type enableApache and press Enter. This sets the web server to start at every system boot up. If you do not want to reboot to start the web server, you may run following as root: /etc/rc.d/init.d/apache start

To disable web server type disableApache and press Enter. This sets the web server not to start at system boot up. If you do not want to reboot to stop the web server, you may run following as root: /etc/rc.d/init.d/apache stop.

d) Restart the computer is optional if you manually start or stop the web server, otherwise, Restart the computer.

Where is the Apache configuration file?
It is in /etc/apache/, name of the file is httpd.conf. Click here to learn more info.

12. Distribute Tomahawk Desktop

How do I participate to distribute the Evaluation version of Tomahawk Desktop via BitTorrent?

NOTE: There are two methods, you may implement either one, but not both. Please see the Advantageous and Disadvantageous of both methods before implement.

Method 1

Advantageous: Simple to implement.
Disadvantageous: Takes long time to start Tomahawk Desktop.

a) Make sure you have configured your network or computer so that outside BitTorrent requests can reach your computer. For more info, please read this.

b) Login to Tomahawk Desktop as root.

c) Use your preferred text editor (eg. Kate) and open the /etc/rc.d/rc.local file.

d) Add following to /etc/rc.d/rc.local:

sudo -u <yourUserName> bittorrent-console --save_as /home/<yourUserName>/TDS-1.1-i386-dvd.iso http://www.tomahawkcomputers.com/download/TDS-1.1-i386-dvd.iso.torrent --max_upload_rate 25 >& /dev/null &

e) Replace <yourUserName> with your user name. That is, your login name. The 25 is the upload speed in Kilo Bytes. Adjust this depend on your upload bandwitdh. Do not exceed your upload bandwitdh. Eg. If your upload bandwitdh is 350Kbps, that is, 43.75KBps. Use about 30 to 35 as your --max_upload_rate.

f) Now if you do have the full TDS-1.1-i386-dvd.iso file, copy it into your home directory. If you don't have it, once you restart your computer, it will first download it.

g) If you copied the TDS-1.1-i386-dvd.iso file, please make sure you have write permission on the file. Run following as root to set correct permissions:

chown <yourUserName>:<yourUserName> /home/<yourUserName>/TDS-1.1-i386-dvd.iso

h) Restart the computer.

Method 2 (Recommended)

Advantageous: Does not slow down the Tomahawk Desktop start. Seeding starts 5 mins after system boot up.
Disadvantageous: Requires more skills in Unix.

a) Make sure you have configured your network or computer so that outside BitTorrent requests can reach your computer. For more info, please read this.

b) Click Konsole button on the KDE Panel to open a Konsole.

c) su and login as root.

d) Type fcrontab -e and press Enter.

e) Add following:

# run (n) minutes after system bootup
@volatile,first(5) 12m /usr/bin/sudo -u <yourUserName> /usr/bin/bittorrent-console --save_as /home/<yourUserName>/TDS-1.1-i386-dvd.iso http://www.tomahawkcomputers.com/download/TDS-1.1-i386-dvd.iso.torrent --max_upload_rate 25 >& /dev/null &

Note: Press i to enter into Insert mode.

f) Replace <yourUserName> with your user name. That is, your login name. The 25 is the upload speed in Kilo Bytes. Adjust this depend on your upload bandwitdh. Do not exceed your upload bandwitdh. Eg. If your upload bandwitdh is 350Kbps, that is, 43.75KBps. Use about 30 to 35 as your --max_upload_rate.

g) Save the fcrontab.

Note: Press Esc to exit from the Insert mode, :wq! to save and exit.

h) Now if you do have the full TDS-1.1-i386-dvd.iso file, copy it into your home directory. If you don't have it, once you restart your computer, it will first download it.

i) If you copied the TDS-1.1-i386-dvd.iso file, please make sure you have write permission on the file. Run following as root to set correct permissions:

chown <yourUserName>:<yourUserName> /home/<yourUserName>/TDS-1.1-i386-dvd.iso

j) Restart the computer.

Volunteer

Notice