1. Install Docker on your machine
2. Get a Docker image for a CS 1.6 server (I created this one, which is based off of an existing one. Mine has:
   • A lot of maps
   • Metamod
   • AMXModX (with high ping kicker, podbot control menu, round money, rock the vote, and admin all in one)
   • Podbot
3. Customise the server (e.g. editing the server.cfg, amxx.cfg, and other config files, etc.)
4. Start it up! (the README.md in the above linked Git repos has more info on this)

As far as ports go, I only needed to forward 27015 on my machine, but your mileage may vary. Others have reported that some more ports must also be forwarded on some machines.

Then optionally, if you’re running Ubuntu and you want this server to start up like a service via systemd, you’ll need this:

1. An executable script with path /usr/local/bin/hlds with contents (make sure the DIR variable matches your installation directory):

#!/bin/sh

# Do not change this path
PATH=/bin:/usr/bin:/sbin:/usr/sbin:/usr/local/bin

# The path to the game you want to host. example = /home/newuser/dod
DIR=/opt/cs-16-server/bin
DAEMON=./server

start()
{
    echo  -n "Starting HLDS"
    if [ -e $DIR ]; then
        cd $DIR
        $DAEMON start
    else
        echo "No such directory: $DIR!"
    fi
}

stop()
{
    echo -n "Stopping HLDS"
    if [ -e $DIR ]; then
        cd $DIR
        $DAEMON stop
    else
        echo "No such directory: $DIR!"
    fi
}

reload()
{
    echo -n "Restarting HLDS"
    stop
    sleep 1
    start
}

case "$1" in
    start|stop|reload)
        "$1"
        ;;
    *)
        echo  "Usage: $ 0 {start | stop | reload | status}"
        exit  1
        ;;
esac

exit  0

2. A script with path /etc/systemd/system/hlds.service with contents:

[Unit]
Description=HLDS

[Service]
Type=oneshot
ExecStart=/usr/local/bin/hlds start
ExecStop=/usr/local/bin/hlds stop
ExecReload=/usr/local/bin/hlds reload
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target

3. Then execute:

systemctl daemon-reload
systemctl enable hlds
service hlds start

Feel free to check out my server that’s running right now with the same Docker image! Here’s the command to connect via the console.

connect henrypoon.com:27015

My computer specifications:

• Intel Core i5-4570
• 16 GB Memory
• Radeon HD 5770

I followed the instructions here, with these changes:

• Using video driver “fglrx-updates” (the tutorial talks about NVIDIA cards)
• Did not install TuxLoL
• Did not do anything regarding the “Maestro error” since it only applies to Optimus Notebook users
• Did not follow step 6 because I did not run into the problem for big item icon text for the item shop
• EDIT: Thanks to Ingvar’s comment, the installation progress for the game can be viewed like so: open terminal (Ctrl+Alt+T) and execute:

tail -f ~/.PlayOnLinux/wineprefix/LeagueOfLegends/drive_c/Riot\ Games/League\ of\ Legends/Logs/Patcher\ Logs/*.log

There are also other steps that I had to do, which I read from here:

• Click configure for the “League of Legends” entry in “PlayOnLinux” and find the “Display” tab and then choose the following options:
  • Direct Draw Renderer – gdi
  • Video memory size – 4096 (or something else depending on graphics card)
  • Offscreen rendering mode – fbo\0
  • Everything else on default
• Create a file called “game.cfg” in the directory “/home/your-username-here/PlayOnLinux’s virtual drives/LeagueOfLegends/drive_c/Riot Games/League of Legends/Config”. Below is what I have in my “game.cfg”:

[General]
EnableAudio=1
GameMouseSpeed=10
UserSetResolution=1
BindSysKeys=0
SnapCameraOnRespawn=0
OSXMouseAcceleration=1
AutoAcquireTarget=0
EnableLightFx=0
WindowMode=0
ShowTurretRangeIndicators=0
PredictMovement=0
WaitForVerticalSync=0
Colors=32
Height=1080
Width=1920
SystemMouseSpeed=0
CfgVersion=5.3.296
x3d_platform=1

[HUD]
CameraLockMode=0
MiddleClickDragScrollEnabled=0
KeyboardScrollSpeed=0.5000
ChatScale=50
ObjectTooltips=0
AutoDisplayTarget=0
ShowAllChannelChat=1
ShowTimestamps=1
ItemShopPrevY=39
ItemShopPrevX=106
NameTagDisplay=1
ShowChampionIndicator=0
ShowSummonerNames=1
ScrollSmoothingEnabled=0
MiddleMouseScrollSpeed=0.5000
MapScrollSpeed=0.5000
ShowAttackRadius=0
NumericCooldownFormat=1
SmartCastOnKeyRelease=0
EnableLineMissileVis=0
FlipMiniMap=1
ItemShopResizeHeight=0
ItemShopResizeWidth=164
ItemShopPrevResizeHeight=1080
ItemShopPrevResizeWidth=1920
ItemShopItemDisplayMode=1
ItemShopStartPane=1

[Performance]
CharacterInking=1
ShadowsEnabled=1
EnableHUDAnimations=0
PerPixelPointLighting=0
EnableParticleOptimizations=0
BudgetOverdrawAverage=0
BudgetSkinnedVertexCount=0
BudgetSkinnedDrawCallCount=0
BudgetTextureUsage=0
BudgetVertexCount=0
BudgetTriangleCount=0
BudgetDrawCallCount=0
EnableGrassSwaying=0
EnableFXAA=0
AdvancedShader=0
FrameCapType=6
GammaEnabled=0
Full3DModeEnabled=0
AutoPerformanceSettings=0
CharacterQuality=4
EffectsQuality=4
EnvironmentQuality=4
ShadowQuality=4
GraphicsSlider=6
paths=0

[FloatingText]
EnemyTrueDamageCritical_Enabled=1
EnemyMagicalDamageCritical_Enabled=1
EnemyPhysicalDamageCritical_Enabled=1
TrueDamageCritical_Enabled=1
MagicalDamageCritical_Enabled=1
PhysicalDamageCritical_Enabled=1
Countdown_Enabled=0
EnemyTrueDamage_Enabled=0
EnemyMagicalDamage_Enabled=0
EnemyPhysicalDamage_Enabled=0
TrueDamage_Enabled=0
MagicalDamage_Enabled=0
PhysicalDamage_Enabled=0
Score_Enabled=0
QuestComplete_Enabled=0
QuestReceived_Enabled=0
Disable_Enabled=0
Level_Enabled=0
Dodge_Enabled=0
Heal_Enabled=0
Special_Enabled=0
Invulnerable_Enabled=0
Debug_Enabled=0
Absorbed_Enabled=0
OMW_Enabled=0
EnemyCritical_Enabled=0
MagicCritical_Enabled=0
Critical_Enabled=0

[Volume]
SfxVolume=0.5
MasterVolume=0.5

This guide presents how to mimic the system used in professional karaoke establishments at home.  The software this system uses revolves around a Taiwanese program called JetKTV.  Much of the content from this guide was drawn from Chinese language websites discussing the usage of this program (scroll all the way down for References).    There is little literature on this subject in English and so this guide presents basically an English version of the reference sites plus a few added notes.

The program used is in Chinese, so people who are not fluent in Chinese may have a hard time navigating through the software.  Those who are brave enough to continue or have a basic knowledge of Chinese with better English fluency may find it helpful to see English instructions.  The Chinese sites on this subject are also written for older versions, and the setup procedure for those older versions are slightly different.

Contents

• Proposed Setup
• Setting Up JetKTV2010
• Inserting A New Song
• Inserting A New Artist
• Testing
• References

Proposed Setup

The proposed setup of all the hardware (TV’s, amps, computer, etc.) is in the diagram below.

The computer will play the chosen Karaoke videos and transmit the video signal to the TV (via extended display like in a dual monitor set up).  The computer’s audio will go to an amplifier or a mixer, which is then transmitted to a set of speakers.  Microphones are plugged into the amplifier/mixer is well so that the speakers can also play the sound picked up by the microphones.  Depending on the hardware, the cables could be different (some TV’s may not have HD output etc.)The  computer is the source of all the signals transmitted to the other devices and must be set up with the Karaoke software.

Setting up JetKTV2010

The PC will use the following software:

• JetKTV2010 (link)
• SongMgr (optional – not helpful on English language PC’s – more on that topic later)

It is helpful to set up the software using a dual monitor setup.  That way, it is easier to test without having to go and plug the computer to the TV each time.

Unzip the contents of the JetKTV2010 program in a folder and open JetKTV2010.exe.  The GUI buttons are for searching through the database (by looking for the artist, song name, etc.) to find the wanted song. Once a song is selected, it will be added to the list of songs to play just like the software at actual Karaoke establishments. The video will play in full screen on one monitor and the song picker GUI will say on another monitor.  To close the program, click on the top left corner of the GUI (hidden button).

Some of the software features in addition to searching and adding songs:

• Skipping songs
• Fast forwarding, pausing, etc.
• Switching from one audio channel to both audio channels (alternating between vocal on/off)

This program reads from a database that contains the song names, artists, language, etc.   Therefore, it does not come with songs.  Songs must be downloaded separately and added on.  These can come from existing DVD’s or YouTube.  The next section will explain how to populate the database.

Populating the Database

The SongMgr program mentioned above can add/remove contents from the database, but there are problems with it when using it on English language PC’s due to problems in encoding some of the Chinese characters.  Even Microsoft AppLocale fails to rectify the problems.  The solution is to use Microsoft Access to open up the database file directly and make changes.

Adding one song can seem like a lengthy process at the first try, but it will get easier as one becomes more familiar with the system.

Inserting A New Song

To insert a new song, one must navigate to the table where the songs are stored and then add an entry to it.

1. Open Song.mdbin the JetKTV program directory
2. When prompted for a password, input “tmwcmgumbonqd” without quotes
3. Navigate to the table Tbl_Song.  This is the table that records all the song entries.

Below is an explanation of each column:

• Song_ID: numerical identifier for each song (the program lists them as 5 digit numbers starting at 10000)
• Song_Title: song title
• Song_Singer: each singer has a unique number associated with them (see next section)
• Song_Singer (2nd one): the name of the artist in text
• Song_Word: number of characters in the song name
• Song_Type: a number representing a language (Mandarin,Taiwanese,Cantonese,Hakka Chinese,English,Japanese,Movies,Cartoons,Other  in that order starting from 1)
• Song_Volume: song volume, but not sure what units they are in.  Default value is 70.
• Song_Channel: the audio channel that does not have the vocal track. (1-Left, 2-Right, 3-Both)
• Song_FileName: filename of the video without the directory
• Song_Path: the directory to the file (could use absolute pathing only, but unsure of whether relative paths work)
• Song_Create: the time that the song was added in
• Song_Count: the play count of a song
• Song_Juyin: the Zhuyin characters representing the song title
• Song_Stroke: number of strokes in the first character of the song name

Some of the columns can be left out, but that means that it will not be possible to find a particular song using the omitted information.  For example, Song_Juyin can be left out for those who dont use the Zhuyin system, and that feature won’t be used for song searching anyway.

To add a song, fill out the following information at the minimum on one row:

• Song_ID (must be a unique number and should have five digits)
• Song_Title
• Song_Singer
• Song_Volume (70 is the default)
• Song_Channel
• Song_FileName
• Song_Path

For the Song_Singer information, refer to the next section.

Inserting A New Artist

Artist information is stored on a different table called Tbl_Singer

1. Open the table called Tbl_Singer
2. Fill out an entire row to add a new singer (see below for the reference for each information column)

Below is an explanation of each column:

• Singer_ID: unique identifier for each singer (this is the unique ID that is to put inserted in the Song_Singer column in Tbl_Song)
• Singer_Sex: singer gender (0-Female, 1-Male, 2-Group/Band)
• Singer_Name: artist name in text
• Singer_Juyin: the Zhuyin characters representing the artist name
• Singer_Stroke: number of strokes in the first character of the artist’s name

Testing

One a song or two has been entered into the database, one can test it by opening up the JetKTV program and trying to pick a song.  It is working when one screen shows the video playing and another screen showing the JetKTV GUI.

One can also try clicking the button labeled “導唱” to test if the audio channels are set up properly (toggling it turns on and off the vocals).

The next step would be to plug in the computer with all the television components and then trying it again.  Once everything works, the system is ready.

References

All reference sites are in Chinese

[1] 動手打造窮人 KTV <http://www.jetktv.ktvdiy.com/> [Update 2022 October: JetKTV seems to be defunct]

[2] [影音相關] JetKTV 輕鬆打造免費 KTV 點唱機 (進階設定篇) <http://www.soft4fun.net/video-related/%E5%BD%B1%E9%9F%B3%E7%9B%B8%E9%97%9C-jetktv-%E8%BC%95%E9%AC%86%E6%89%93%E9%80%A0%E5%85%8D%E8%B2%BB-ktv-%E9%BB%9E%E5%94%B1%E6%A9%9F-%E9%80%B2%E9%9A%8E%E8%A8%AD%E5%AE%9A%E7%AF%87.htm#doublescr>

[3] 峰網誌 JetKTV-DIY電腦點歌機..軟體篇 <http://www.wretch.cc/blog/Linpy/4853370>

• RXTX
• JavaComm

Unfortunately, the current version of JavaComm does not support Windows, and only supports Solaris SPARC, Solaris x86, and Linux x86.  Since I use none of those operating systems, this article will only discuss how to install RXTX in Windows.

UPDATE: 12 Sept 2011 – Thanks to a comment from Kurt Zoglmann, there are instructions on how to do this with a Mac!  I never tried this myself because I don’t have a Mac, but the procedures stated there look good to me (see comments).

A 32 and 64 bit version of the library exists.   I’ve updated this article from when it was first published to include the new locations for where to download the libraries, but I have not gone through the installation of the libraries again, so I’m not surprised if the rest of the content on this page is outdated too.

32-bit version: http://rxtx.qbang.org/wiki/index.php/Download
64-bit version: http://fizzed.com/oss/rxtx-for-java

To install the libraries (instructions from JControl):

1. Copy rxtxSerial.dll to %JAVA_HOME%\bin, (%JAVA_HOME% is the folder where JRE is installed on your system; e.g. c:\Program Files\Java\j2re1.4.1_01)
2. Copy RXTXcomm.jar to %JAVA_HOME%\lib\ext

Once installed, the IDE will need to know where to look for these installed files.  Even though the files exist in the JRE directory, each project needs to know about these files.  More information on this website.

In order to start coding with this library, import gnu.io.*.  For more information about Java Serial Programming, look here.

Happy coding!

However, this poses a problem for syncing the desktop folder.  I wasn’t going to move everything on my desktop to the dropbox folder because that would mean I wouldn’t be able to see these files on the desktop anymore.  Also, if I did put a symlink in my user folder, network shares would be broken since other computers cant follow symlinks when using network access.  I couldn’t go back to putting a symlink in the Dropbox directory due to the problem that I just had.  So what I did was use LiveMesh.  LiveMesh has the ability to follow symlinks while the program is running.  Now I put up a symlink for my Desktop in my Documents folder and now the program just syncs that.  For some reason, LiveMesh can’t sync the Desktop folder directly.

I might just ditch Dropbox altogether so I can do all my file syncing using LiveMesh.

However, I stumbled upon something called symbolic links (symlinks for short).  Basically it is a pointer to another directory.  I put a symlink in my Dropbox folder which pointed to my desktop and now inside my Dropbox folder there is a folder called “Desktop”.  Well, it’s not exactly a folder.  It’s a symbolic link.  When the computer follows the link when I double click it, it just leads to the destination directory that I set.  So now Dropbox has no problem syncing that directory!

EDIT May 21, 2010: Apparently Dropbox can’t actually follow the symlinks inside the Dropbox directory while its running.  The originals have to be inside the Dropbox folder and the symlink has to be put at where you used to access those files before.  At the same time, shortcuts can be used in place of symlinks.

More info about symlinks here: http://en.wikipedia.org/wiki/Symbolic_link