Starting MyTunesRSS

There are three different distributions of MyTunesRSS. You can download a Windows version, a Mac OS X version and a platform independent version. Basically they are all the same with a few minor differences. The Windows version offers an EXE wrapper, so you can simply double click the EXE file to start MyTunesRSS. The OS X version is an application bundle which offers the same for Mac computers. The independent version is plain Java and needs to be started on the command line to enter all the necessary parameters. This can be used on Linux systems for example. It will work the same as the above system dependent versions and you will need it on Windows or Mac computers as well if you are going to use the headless mode. If you are using the Windows or Mac specific version you can skip the rest of this page.

First, please simply type java on the command line to check if you have the correct version installed and available. You might have to type the complete path to the Java executable. This depends on your system and where Java is installed, You need Java 1.5 or better to run MyTunesRSS. The minimal command line for starting MyTunesRSS in normal operating mode is the following (this is one line, it is cut into multiple lines for clarity reasons here): 

java -Xms256m -Xmx256m
    -Xbootclasspath/p:lib/xercesImpl-2.8.1.jar:lib/codewave-zis-1.1.jar
    -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl
    -Dde.codewave.mytunesrss
    -jar mytunesrss.jar

The above command line starts MyTunesRSS in the same mode the Windows EXE wrapper or the Mac OS X application bundle do. You can add an additional parameter at the end of the command line. 

-headless

The -headless option runs MyTunesRSS in a special mode without any GUI.

You can also specify the configuration file name with a system property. A system property is specified with the special -Dkey=value format just like the javax.xml.parsers.SAXParserFactory above. 

-Dsettings-file=some-file-name.xml

The default name is settings.xml. The settings file is stored in the configuration folder (see separate chapter).