Skip to content
Fabrizio Stellato edited this page Jan 14, 2018 · 7 revisions

Xrns2MOD is a tool that convert renoise song format to mod or xm format

Things to know

Startup

First off download both Xrns2XMod main application and tool
The tool is an essential UI utility either for converting the song to desired format or help the user to set correct command values

Adjusting volume sample on Renoise

While mod/xm do not have a volume value for sample (they have a default sample volume instead), Xrns2XMod can use 2 distinct approach to let the sample play with the same Renoise's volume.

Sample mode (default)
Xrns2XMod can "readjust" the sample data according to the Renoise volume value set for each sample These images show the result of the re-sample process based from the original sample volume

renoise original sample, with volume set to -10 db
renoise_resample_to_volume

converted sample
mod_resample_to_volume

Column mode (xm only)

With column mode, any volume effect will be scaled according to the original volume of the playing sample. Notice that also default volume for sample (if is not equal to 64) is taken into consideration. The sample data remains unchanged.

An example of the volume column conversion with 2 samples (one on the left and one on the right): volume value is 0db
volume_column_original

right volume value is -12db
volume_column_converted

Default Sample Volume

Renoise can't handle default volume sample, by the way it is possible to set a default volume for the sample in Xrns2XMod and then simulate it by setting the default volume value on second effect column of renoise (which is always ignored by Xrns2Xmod itself)

Use the helper tool to assign the default volume and assign a key assigned to this macro feature

the default volume macro will assign the value to the second effect column of the line selected
default_volume

See below this documentation to read about instruments settings dialog tool

Global volume effect

Starting from Renoise 2.8, Global effect volume must be set inside the mastertrack column

Xrns2XMod get the the volume effect command seeking the mastertack first column and then set the result on the first free column effect found starting from the left. An example below:

Global Volume
mastertrack

The Global Volume effect, put on the free empty slot
mastertrack_converted

Therefore, take care to leave an empty slot on any instrument track in the line after using global volume effect

Playback options

playback_mode

OS Mode can be set in either ways, because Xrns2XMod can convert the Renoise value to Amiga/FT2. Btw, keep in mind that samples over 65536 bytes might have inaccurate value.

Pitch Mode can be used in either Renoise or Amiga/FT2 mode. In order to use Extrafine portamento values, use Renoise mode instead of Amiga/FT2 Notice: if value is set to Renoise, use the Helper Tool window to not mess up with wrong or inaccurate values.

Note about pitch on MOD format
On MOD format, portamento effects are consistent throughout the note scale (see the Amiga linear frequency table).
Since version 4.x, Xrns2XMod scan any note / portamento though pattern to achieve the right portamento value for played frequency.

Command Line

usage for command line is:

Xrns2ModCmd.exe «inputFile»

-t|type [ mod | xm ] (destination format)
-portresh (Portamento treshold value (0-4, default: 2) (affects only mod)
-ptmode (ProTracker note range limitation) (default: true)
-volscal (scale volume according to renoise sample volume) [ none | sample | volume ] (default: sample)
-tempo [32 - 512] initial tempo value (affects only xm)
-ticks [1 - 31] initial ticks / row value (affects only xm)
-out «file» (output filename)
-log file» (log filename)
-bass_email {bass email}
-bass_code {bass_code}

Options

-type

Specifies the format destination format

-portresh (default: 2)

When set to 4, Portamento will be prefered to ExtraFine Portamento command at the cost of inaccurate tone. Set 0 to always use ExtraFine Portamento (whenever possible) even when finetune value of 1 may be loss (discouraged)

-ptmode (affects only mod)

if set to false, extended NOT-ProTracker notes are available

-volscal=[value] Volume scaling, based to renoise sample volume

possibile values are: none: renoise's sample volume won't affect the resulted mod/xm's sample sample: target sample data will change according to renoise volume volume: renoise sample volume will affect volume column of playing channel (only for xm)

See also Sample Volume for further information:

-tempo Initial tempo for xm modules [32 - 512]

-ticks Initial tempo for xm modules [1 - 31]

**-out «filename» **

output filename.

default value is the same name of the source with the target format extension.

**-log «filename» **

log filename.

-bass email «bass email»

set bass email for registrated user

-bass code «bass code»

set bass code for registrated user

Window GUI

xrns2xmod_gui

The Xrns2XMod GUI is the windows interface to access all the Xrns2XMod features

Tool

Download the Xrns2XMod Tool here

Menu

menu

With menu it is possible to access to windows or templates, demo or other Xrns2XMod stuff. Some menu may be disabled according to the context or if main application path is not set

Control Panel

control_panel

With control panel it is possible to locate Xrns2XMod application path

Converter

converter

Main window for converting and adjust specific conversion settings

Helper

helper

Window that help user to set correct portamento/volume values without messing up with accuracy conversion

Instrument Settings

instrument_settings

Assign sample's default volume and sample rate for each sample.

Default value for volume is 64, while the converted sample rate is the actual sample rate

Linux/Mac

Xrns2XMod Shell on Ubuntu platform screenshot from 2014-10-28 08-14-11

To run Xrns2XModShell under Linux, you must install Mono runtime. Once mono runtime is correctly installed, download Xrns2XModShell.tar.gz file, copy zipped contents wherever you want and copy the *.so files located under "libs/[x64|x86]" directory (depending to your system's architecture) into Xrns2XModCmd root folder, then run Xrns2XModShell.exe in the same way of Windows binary.

Take a look to README_linux.txt for any further information

Note for Mac users:
Xrns2XMod has not been tested on any Mac OS yet, by the way it may be possible to compile and run it. For this purpose, try the following:

  1. Download Xrns2XMod source code on this site:
  2. Download and install monodevelop on your OSX system
  3. Open the solution from the Xrns2XMod source , then Build / Rebuild all
  4. Copy the generated content wherever you like
  5. Open the BASS site and download bass.dylib, libbassflac.dylib, libbassmix.dylib, then copy these files into Xrns2XMod folder

MonoDevelop
screenshot from 2014-10-28 08-43-11

A screenshot on Linux platform
ubuntu

Resources

Video

Video tutorial
Demonstration video

Test

Look into Resources folder under executable folder

Music

Towards A New Decade.xrns a whole song, pro tracker convertible
Lack of Time.xrns a pro tracker convertible module (read Song Comments before convert)
Temple of the competitors (game version new).xrns a song written for an iPhone game

Clone this wiki locally