You are on page 1of 4

OpenMSX Readme - An OpenTTD Music replacement set

===============================
Current Version: OpenMSX 0.3.1
===============================

Contents
0 About OpenMSX
1 Installing
2 Troubleshooting
3 Contributing and compiling from source
4 License
5 Credits

0 About OpenMSX
===============

OpenMSX is an open source replacement for the original Transport Tycoon Deluxe
(TTD) music. All contributions are licensed under the GPL v2.

1 Installing
============

1. First, make sure that you downloaded and installed at least OpenTTD version
1.0.0 or later.

2.
a) Manually:
Next, download the latest OpenMSX package. There are a few sources:
- the development homepage http://bundles.openttdcoop.org/openmsx
- Look for "OpenMSX" on one of the OpenTTD binaries servers, it is found in the
"bananas" section:
http://binaries.openttd.org/bananas/OpenMSX-0.2.1.tar.gz (or possibly with a
newer version).

Unpack the zip file into the OpenTTD /gm directory (see section 4.2 of the
OpenTTD readme for a detailed treatise on all data dirs OpenTTD recognizes).
- An OpenTTD folder in your user account's home directory:
Windows: C:\My Documents (95, 98, ME)
C:\Documents and Settings\<username>\My Documents\OpenTTD (2000,
XP)
C:\Users\<username>\Documents\OpenTTD (Vista, 7)
Mac OSX: ~/Documents/OpenTTD
Linux: ~/.openttd
- The OpenTTD installation directory.

b) Via ingame content download:
- Go to the content download, and search for OpenMSX; it's found in the baseset
category.

3. In the main menu of the game, click the Game Options button. The Game
Options dialog will appear.

4. Select OpenMSX from the drop-down list below Base Music set if that's not
selected already (bottom left of window). Close the window using the × in the

if you have problems with windows' default dmusic driver.org/projects/home/wiki and the very extensive and detailed installation instructions on the mingw wiki at http://www.some gnu utils: make.python (if you use mercurial.txt for a more detailed and possibly more up to date description of windows music driver issues. 2 Troubleshooting and bad sound output ====================================== Depending upon the hardware and the music driver used. Prerequisites to building OpenMSX: .org/openmsx/releases.g. sed .org/wiki/Getting_Started On Linux: your system should already have most tools.org/hg/openmsx or obtain the tarball from http://bundles.openttdcoop. For installation instructions concerning mercurial refer to the manual of your distribution. OpenTTD may have problems to playback some songs without error or that it may happen that subsequent sound output is changed in a detrimental way.unix2dos for convenient conversion of the text files .upper left corner. cat.openttdcoop.selenic. Search your openttd. mingw) or md5 (mac) . if you're having trouble getting OpenMSX to work. was it? Anyways.openttdcoop. Mercurial is easiest insalled via macports: sudo port install mercurial The use of mercurial is strongly encouraged as only that allows to keep track of changes.openttdcoop. you'll have python) and you might additionally want a text editor of your choice and possibly a programme capable of creating and editing midi files. On Mac: Install the developers tools. you'll probably only mercurial available from the source mentioned above. The latter is especially know to happen with the windows "dmusic" sound driver. You can do an anonymous checkout from http://mz. e. Consult also the OpenTTD readme for available options and its known-bugs. using hg clone http://mz. what error messages you got and where you got stuck at our bug tracker at http://dev.md5sum (linux. .com/wiki/Download?action=show&redirect=BinaryPackages) . Now that wasn't so hard.mercurial (only when not building from a tarball. You may want to try the "win32" music driver. On Windows: we advise to get a mingw development environment.org/hg/openmsx . download mercurial from the sources mentioned above) For more detailed instructions see our guide at http://dev.openttdcoop. available from http://mercurial. 3 Contributing and compiling from source ======================================== The OpenMSX source is available in a Mercurial repository or as gzip'ed tarball.mingw.org/projects/openmsx or in the tt-forums. please file a detailed report on what you did.cfg for "musicdriver" and change the line to "musidriver = win32".

write to the Free Software Foundation. without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.bundle_zip: create a zip archive of OpenMSX . MA 02110-1301 USA.check: checks the md5 sums of the built grf and obg files against those of the official release versions Given the usual case that you modify something within OpenMSX and want to test that.htm) ttsong_iv_imuh3.mid: Kyle Timmerman (Mr. The following targets are available: .redfarn/MidiPage. Mind to re-start OpenTTD as it needs to re-read the grf files. Given default paths. 4 License ========= OpenMSX Music Replacement Set for OpenTTD Copyright (C) 2010 OpenMSX Authors (see below or in the source in themes. 5 Credits ========= OpenMSX is created by the following people (in order of the song list): programming and coordination Ingo von Borstel (planetmaker) music critic and advisor: kamnet tttheme2. a 'make install' will overwrite a previous nightly version of OpenMSX. 1 Franklin Street. Fifth Floor.com/jim.bundle_tar: create a tar archive of OpenMSX . if not. Use Makefile.local to specify a different path .mrproper: also cleans generated directories .mid: mimm ttsong_iii_imuh3.mid: mimm the_fast_route.mid: -lucas- big_man_boogie_redfarn.all: builds all grfs and the obm file . See the GNU General Public License for more details. Boston.Once all tools are installed. get a checkout of the repository and you can build OpenMSX using make. but WITHOUT ANY WARRANTY. Inc.. if you selected the nightly version of OpenMSX. you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.install: build and then copy OpenMSX in your OpenTTD music directory.mid: imuh3 flying_scotsman. You should have received a copy of the GNU General Public License along with this program.list) and is licensed under GPL v2.bundle_src: create a source tarball .mid: imuh3 train_filled_with_cash. a simple 'make install' should suffice and you can immediately test the changes ingame.ntlworld. This program is distributed in the hope that it will be useful. This program is free software.clean: cleans all generated files .Ksoft) busy_schedule.mid: imuh3 .mid: imuh3 modern_motion.mid: Jim Redfarn (http://homepage.bundle_bz2: create a bzip2 archive of OpenMSX .

ntlworld.mid: Jim Redfarn (http://homepage.ntlworld.ntlworld.ntlworld.mid: Tistou Blomberg midnight_snow_run.com/jim.com/jim.htm) slow_neasy_redfarn.com/jim.redfarn/MidiPage.com/jim. Gene de Paul.mid: Jim Redfarn (http://homepage.mid: Tistou Blomberg 5432gone_redfarn.htm) ultimate_run.ntlworld.htm) moo_redfarn.ntlworld.ntlworld.mid: Tistou Blomberg wood_whistles.mid: Jim Redfarn (http://homepage.mid: Jim Redfarn (http://homepage.com/jim.htm) inspired by Cow Cow Boogie by Benny Carter.mid: Jim Redfarn (http://homepage.mid: imuh3 the_hobo_redfarn.ntlworld.mid: Jim Redfarn (http://homepage.ntlworld.mid: Tistou Blomberg linns_basket.htm) be_sharp_bw_redfarn.mid: Tistou Blomberg chemistry_lab.com/jim.htm) traditional song mosey_along_redfarn.redfarn/MidiPage.mid: Tistou Blomberg mighty_giant_run. and Don Raye say_what_redfarn.chuggachugga.htm) .redfarn/MidiPage.ntlworld.mid: Tistou Blomberg coconut_run2.redfarn/MidiPage.htm) no_work_song_redfarn.redfarn/MidiPage.redfarn/MidiPage.mid: Jim Redfarn (http://homepage.com/jim.ntlworld.htm) boogi_marabi_redfarn.htm) careless_perc_redfarn.mid: Tistou Blomberg harp_harmony.com/jim.redfarn/MidiPage.redfarn/MidiPage.redfarn/MidiPage.redfarn/MidiPage.com/jim.mid: Tistou Blomberg relax_song.mid: Jim Redfarn (http://homepage.htm) city_blues_redfarn.com/jim.mid: Jim Redfarn (http://homepage.com/jim.mid: Jim Redfarn (http://homepage.mid: Tistou Blomberg run_for_your_life.mid: Jim Redfarn (http://homepage.redfarn/MidiPage.