Sierra Wiki - User contributions [en]

Adlib ROL to AGI Sound

2025-05-29T15:41:04Z

Sinus:

[[Category:AGI Pages]]
<div align="center" style="font-size: 22pt">ROL2SND</div>
<div align="center">Version 1.1<br />
''Author: [[Lance Ewing]] and [[Anders M. Olsson]]''<br />
[[1998]]</div>

{{FanAGISoftwareInfobox
| Software = ROL2SND
| Image = 
| Version = 1.1
| ReleaseDate = [[1998]]
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{LanceEwingToolDev}}, {{AndersMOlssonToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{C}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}} [[#Downlaod|Yes]] (Included in download)
| License = {{NoLicense}}
| Platform = {{DOSTool}}
| Type = {{AGISoundConverter}}
| Localization = {{EnglishTool}}
| Website = {{agifansURL}}
}}

<br />
==<br /><br /> Description ==

<blockquote>
[[Lance Ewing]]'s '''''ROL2SND''''' is a DOS command line tool for converting a music file in the Adlib ROL format to an AGI SOUND resource. The reason this tool exists is because I had an Adlib sound card way back when sound cards first came out. It came with a music composer tool called Visual Composer. I was fairly musical and had written a lot of music with this tool, so I decided to build an AGI utility to convert the saved files into AGI SOUNDs.

It converts the first three voices of an Adlib ROL file (as used with Visual Composer) into an AGI sound resource. I've made this program available in case some one else out there still has an old ROL editor.
</blockquote>

==<br /> Features ==

*

==<br /> Version History ==

<blockquote>
 
</blockquote>

==<br /> Development Status ==

<blockquote>
 
</blockquote>

==<br /> Usage ==

* See included documentation

==<br /> Options ==

<blockquote>
 
</blockquote>

==<br /> Download ==

<blockquote>
Download from here:
* [[Image:ZIP.png|ZIP File]] [[File:Adlib_ROL_to_AGI_SOUND_(ROL2SND).zip | Adlib_ROL_to_AGI_SOUND_(ROL2SND).zip]] <span class="DLInfo"> (ZIP file) [355.1 KB]</span> (includes source)
</blockquote>

==<br /> Known issues ==

* None known

== <br />Credits ==

* [[Lance Ewing]] and [[Anders M. Olsson]]

== References ==

<references />

==<br /> Also See ==

*

[[Category:Technical Info]]
[[Category:AGI Sound Utilities]]

Impulse Tracker to AGI Sound

2025-05-29T15:05:24Z

Sinus:

<div align="center"><span style="font-size: 22pt">Impulse Tracker to AGI Sound (IT2AGI)</span><br />Version 0.01<br />''Developer: [[Nat Budin]] ''<br />[[2000|2000/01/23]]</div>

{{FanAGISoftwareInfobox
| Software = Impulse Tracker to AGI Sound
| Image =
| Version = 0.01
| ReleaseDate = {{2000S}}
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{NatBudinToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{Perl}} {{C}} {{C++}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[[#Download|Yes]] (the script is the source)
| License = {{NoLicense}}
| Type = {{FanAGISoundConverter}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}, {{LinuxTool}}
| Localization = {{EnglishTool}}
| Website = {{NAURL}}
}}

<br />
==<br /> A.K.A. ==

* '''IT2AGI'''

==<br /> Description ==

<blockquote>
[[Nat Budin]]'s Impulse Tracker to AGI Sound Perl script converts [[w:ImpulseTracker|ImpulseTracker]] files to the AGI Sound format. You will need [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] to create the music and the [https://www.perl.org/ Perl runtime] to run this Perl script.

[[Sinus's Branch of Impulse Tracker to AGI Sound|Adam Skawiński's updated script]] adds support for Impulse Tracker's 4th channel (noise channel).
{{TechToDo}}
</blockquote>

==<br /> Features ==

*

==<br /> Requirements ==

<blockquote>
* [https://www.perl.org/ Perl runtime]
* [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] or [https://openmpt.org/ OpenMPT]
</blockquote>

==<br /> Version History ==

<blockquote>
 
</blockquote>

==<br /> Development Status ==

<blockquote>
Unmaintained
</blockquote>

==<br /> Usage ==

<blockquote>
To convert music, type this from the command line:
<blockquote>
<code>perl it2agi <name>.it</code>
</blockquote>
Where <name> is the same name as your IT file. The script will produce a file called "<name>.ags".
</blockquote>

==<br /> Options ==

<blockquote>
 
</blockquote>

==<br /> Download ==

<blockquote>
Download from here:
* [[Image:ZIP.png|ZIP File]] [[File:Impulse_Tracker_to_AGI_Sound_(IT2AGI01).zip|Impulse_Tracker_to_AGI_Sound_(IT2AGI01).zip]] v0.01 <span class="DLInfo"> (ZIP file) [3.08 KB]</span> (includes source)
</blockquote>

==<br /> Known issues ==

# IT2AGI uses only the first three channels of an Impulse Tracker file. These are mapped to the three voices of the PCjr sound chip.<ref>See [[#Development Status|Development Status]]</ref>
# IT2AGI doesn't (yet) support changing tempo or speed in the middle of the song. Don't try this, as it will be cruelly ignored.
# Volumes aren't supported either, yet. They will be in the next version. For now, everything is played full blast.
# Finally, AGI is very limited in what it can do. If AGI doesn't support something, IT2AGI most likely doesn't either.

== <br />Credits ==

* [[Nat Budin]]

<blockquote>
=== Acknowledgements ===

<blockquote>
Many thanks go to [[Lance Ewing]]. Not only did he write the [[AGI Specifications: Chapter 9 - Sound Resources|AGI Sound specification]], enabling me to write this program, I also stole a formula off his ROL2SND program. So, thanks Lance!
</blockquote>
</blockquote>

== References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Sound Converters|AGI Sound Converters]]
* [[AGI Specifications: Chapter 9 - Sound Resources]]
* [[Sinus's Branch of Impulse Tracker to AGI Sound]] - IT2AGI enhanced with bugfixes and input formats
 
[[Category:Technical Info]]
[[Category:Sound Converters]]
[[Category:AGI Sound Converters]]
[[Category:AGI Sound Utilities]]

Sinus' Branch of Impulse Tracker to AGI Sound

2025-05-29T15:03:43Z

Sinus: catgory

<div align="center"><div style="font-size: 22pt">Sinus's Branch of Impulse Tracker to AGI Sound</div><br />
Version 0.2.7<br />''Author: [[Adam Skawiński]] and [[Nat Budin]]''<br />2025</div>

{{FanAGISoftwareInfobox
| Software = Impulse Tracker to AGI Sound (Sinus)
| Image =
| Version = 0.2.7
| ReleaseDate = {{2025}}-05-19<ref>https://sciprogramming.com/community/index.php?topic=9284.0</ref>
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{AdamSkawińskiToolDev}}, {{NatBudinToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{Perl}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[https://github.com/SinusPi/any2agi Yes]
| License = {{NoLicense}}
| Type = {{FanAGISoundConverter}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}, {{LinuxTool}}
| Localization = {{EnglishTool}}
| Website = https://github.com/SinusPi/any2agi
}}

<br />
==<br /> A.K.A. ==

* '''''ANY2AGI'''''

==<br /> Description ==

<blockquote>
[[User:Sinus|Adam 'Sinus' Skawiński]]'s branch of [[Nat Budin]]'s [[Impulse Tracker to AGI Sound]] Perl script adds support for noise channel and more input formats (now: IT, MOD and MIDI), as well as some quality-of-life options.

The [https://www.perl.org/ Perl language runtime] is required to run. Input music files may be created with [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] (for DOS only), [https://openmpt.org OpenMPT] or any MIDI editor.
</blockquote>

==Features ==
Input formats:<blockquote>
* Impulse Tracker (.it)
* Protracker (.mod) - basic support only, no tempo support yet
* MIDI (.mid) - input needs to have monophonic tracks or channels, no tempo support yet</blockquote>

== Notes ==
The PCjr sound chip supports only 3 voices and 1 noise channel, so you'll have to use the first 4 channels of an IT file, or use --channels to cherry-pick.

Noise notes are: C-0 (high buzz), C#0 (mid buzz), D-0 (low buzz), D#0 (borrow buzz), C-1 (high noise), C#1 (mid noise), D-1 (low noise), D#1 (borrow noise). "Borrowed" notes play frequencies borrowed from the third channel, though not very precisely. They're good for special effects like explosions or zaps, though, if you play a series of appropriate notes on channel 3 (probably with a volume of 0).

On PC Speaker, only the first channel will be used, other channels will be ignored. Keep that in mind when making your input files. Of course you can also make two separate files, one monophonic for PC Speaker, and one multichannel for PCjr, and play them appropriately from within your game, by checking AGI var 22 - but watch out for memory limits.

If you're writing an IT file from scratch, set tempo to 150 and speed to 1. This will give you a perfect match for the AGI engine's 60 ticks per second, and 16.67 ms per tick.

== Requirements ==

<blockquote>
* [https://www.perl.org/ Perl language runtime]
* [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] (for DOS only) or [https://openmpt.org/ OpenMPT]
</blockquote>

==Usage ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>

The script will produce a file called "<name>.ags".
</blockquote>

==Options ==

<blockquote>
* <code>--channels x,x,x,y</code> - select input channels. Default is <code>--channels 1,2,3,4</code> to output first four channels, with the last being used as noise. <code>--channels 1,2,3</code> would simply omit the noise channel. You'll probably have to use this to pick channels out of multi-channel input files, or rearrange them to put the noise channel last. Midi channels are numbered from 0.

* <code>--tempo-exact</code> - force exact tempo, at the cost of jittery playback. AGI engine plays using 1/60s ticks, so any playback must either use equal note lengths (at the cost of a different BPM from the original - by default), or try to match the original's BPM exactly by using varied note lengths. MIDI conversion uses exact tempo matching only.
* <code>--auto-drum-offs n</code> - automatically terminate notes on the noise channel after <code>n</code> ticks. Useful when converting input files that use short samples and don't bother terminating them, which would turn into long noise notes in AGI.
* <code>--instr-note x y</code> - force instrument <code>x</code> to play only note <code>y</code> . Useful to force a drum-like instrument to play only valid AGI drum notes. Typical notes are 13 (high noise), 14 (middle noise) and 15 (low noise). Combined with <code>--channels</code> to properly map an input channel to the noise output, and <code>--auto-drum-offs</code> to make output drums shorter, this option can turn a typical "rhythm channel" in the input into proper noise channel output for AGI.
* <code>--instr-shift x y</code> - shift (transpose) instrument <code>x</code> by <code>y</code> semitones. Use when input samples were recorded in a weird pitch, and notes in the input were written to match that. Or, use +12 or -12 to transpose by an octave.</blockquote>

== Version History ==

* ''0.2.1: Added recognizing MOD, S3M and XM modules, and MIDI files. They're not (yet?) supported, but recognized.''

* ''0.2.2: Experimental option --channels added''
* ''0.2.3: Tempo mode added: --tempo-exact''
* ''0.2.4: Auto drum note-offs added: --auto-drum-offs 1/2/3...''
* ''0.2.5: very basic MOD and MIDI support added''
* ''0.2.6: --auto-drum-offs now use AGI ticks for scale, not rows;'' ''--instr-drum'' ''added''
* ''0.2.7: --instr-drum changed to --instr-note, and'' ''--instr-oct to --instr-shift''
== Development Status ==

<blockquote>
Last updated: 2025-05-29.
</blockquote>

== Download ==

<blockquote>
Download from here:
* v0.2.2 [[Image:ZIP.png|ZIP File]] [[File:Impulse_Tracker_to_AGI_Sound_(ANY2AGI022).zip|IImpulse Tracker to_AGI Sound 0.2.3 (ANY2AGI022).zip]] <span class="DLInfo"> (ZIP file) [6.24 KB]</span>
* Newest: [[github:SinusPi/any2agi|SinusPi/any2agi on GitHub]]
</blockquote>

==<br /> Known issues ==

# IT2AGI doesn't (yet) support changing tempo or speed in the middle of the song. Don't try this, as it will be cruelly ignored.
# Several other music formats (S3M, XM) are recognized, but not supported.
# Finally, AGI is very limited in what it can do. If AGI doesn't support something, IT2AGI most likely doesn't either.

==<br /> Credits ==

* [[Adam Skawiński]]
* [[Nat Budin]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[AGI Specifications: Chapter 9 - Sound Resources]]
 
[[Category:Sound Converters]]
[[Category:AGI Sound Converters]]
[[Category:AGI Sound Utilities]]

Visual AGI Sound Editor

2025-05-29T15:02:58Z

Sinus: category

[[Category:AGI Pages]]
[[Category:Temp AGI Import Pages]]
<div align="center" style="font-size: 22pt">Visual AGI Sound Editor</div>
<div align="center">Version beta8<br />
''Author: [[Joakim Möller]] and [[Gustaf Wennerholm]]''<br />
[[2002|2002/07/10]]</div>

{{FanAGISoftwareInfobox
| Software = Visual AGI Sound Editor
| Image = [[Image:VisualAGISoundEditor8b.png|190px]]<br />
''Visual AGI Sound Editor Screenshot''
| Version = beta8
| ReleaseDate = [[2002|2002/07/10]]
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{JoakimMöllerToolDev}}, {{GustafWennerholmToolDev}}
| Interface = {{GUI}}
| ProgLanguage = {{C++}}
| OpenSource = {{OpenSRC}}
| License = {{NoLicense}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGISoundEditor}}
| Localization = {{EnglishTool}}
| Website = [http://web.archive.org/web/20060525044157/http://www.algonet.se/~jmoller/vagi/ http://www.algonet.se/~jmoller/vagi/] (archive.org)
}}

<br />
==<br /><br /> Description ==

<blockquote>
Part of [[Joakim Möller]] and [[Gustaf Wennerholm]]'s Visual AGI IDE. Around 2002 the Visual AGI project was started to create new AGI suite in C#, advanced by releasing separate components, yet it was never completed but the source code and two components, picture and sound editor are available for download.

Extract from Visual AGI's homepage:

<blockquote>'''''Visual AGI is a project started by Joakim Möller and Gustaf Wennerholm. Our goal is to provide an integrated development environment for creating games for the Sierra AGI interpreter. It will be written for the .NET framework in C# as a project to learn .NET. '''''</blockquote>

Note, may require the Microsoft Active Accessibility to be installed.
</blockquote>

;Sound editor

Tracker-stylish composing software Visual AGI Sound Editor BETA 8, offered ability to edit three voice tracks and one noise with similar approach like e.g. [[w:FastTracker_2 Fast Tracker|FastTracker_2 Fast Tracker]].

==<br /> Screenshots ==

{| align="center" width="80%"
| align="center"|[[File:VisualAGISoundEditor8b.png|320px]]
|}

==<br /> Features ==

*

==<br /> Version History ==

<blockquote>
 
</blockquote>

==<br /> Development Status ==

<blockquote>
 
</blockquote>

==<br /> Usage ==

#

==<br /> Options ==

<blockquote>
 
</blockquote>

==<br /> Download ==

<blockquote>
Download from here:
* [[Image:ZIP.png|ZIP File]] [[File:Visual_AGI_Sound_Editor_(VAGI_b8).zip|Visual_AGI_Sound_Editor_(VAGI_b8).zip]] <span class="DLInfo"> (ZIP file) [237 KB]</span><br />'''Source:'''
** [[File:ZIPInactive.png|ZIP File]] <span class="Inactive">Visual_AGI_Sound_Editor_SRC.7z<span class="DLInfo"> (ZIP file) [7.13 MB]</span></span>


* [http://www.agidev.com/download/ Download from AGIDev]
</blockquote>

==<br /> Known issues ==

* None known

== <br />Credits ==

* [[Joakim Möller]] and [[Gustaf Wennerholm]]

==<br /> References ==

<references />

==<br /> Also See ==
 
[[Category:Technical Info]]
[[Category:AGI Sound Utilities]]

AGI Sound Resource to MIDI

2025-05-29T15:01:54Z

Sinus: /* Also See */

[[Category:AGI Pages]]
[[Category:Technical Info]]

<div align="center" style="font-size: 22pt">SND2MIDI</div>
<div align="center">Version <br />
''Author: Jens Christian Restemeier''<br />
[[1998]]</div>

{{FanAGISoftwareInfobox
| Software = SND2MIDI
| Image = 
| Version = 1.2
| ReleaseDate = {{1998S}}
| Company = N/A
| Published = {{Published}}
| Developers = {{JensChristianRestemeierToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{C}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}} (Included in download)
| License = {{NoLicense}}
| Platform = {{DOSTool}}
| Type = {{AGISoundResourceTool}}
| Localization = {{EnglishTool}}
| Website =
}}

{{Stub}}

<br />
==<br /><br /> Description ==

<blockquote>
[[Jens Christian Restemeier|Jens Christian Restemeier's]] SND2MIDI is a very simple program to convert an AGI Sound to MIDI.

{{TechToDo}}
</blockquote>


==<br /> Features ==

*

==<br /> Version History ==

<blockquote>
 
</blockquote>

==<br /> Development Status ==

<blockquote>
 
</blockquote>

==<br /> Usage ==

#

==<br /> Download ==

<blockquote>
'''Download from here:'''
* [[Image:ZIP.png|ZIP File]] [[File:AGI_SOUND_to_MIDI_(SND2MIDI).zip|AGI_SOUND_to_MIDI_(SND2MIDI).zip]] <span class="DLInfo"> (ZIP file) [24.7 KB] - (Source included)</span>
</blockquote>

== <br />Known issues ==

*

== <br />Credits ==

* [[Jens Christian Restemeier]]

==<br /> References ==

<references />

== Also See ==

*
 
[[Category:AGI Sound Utilities]]

AGI Sound Resource to MIDI

2025-05-29T15:01:22Z

Sinus: category

[[Category:AGI Pages]]
[[Category:Technical Info]]

<div align="center" style="font-size: 22pt">SND2MIDI</div>
<div align="center">Version <br />
''Author: Jens Christian Restemeier''<br />
[[1998]]</div>

{{FanAGISoftwareInfobox
| Software = SND2MIDI
| Image = 
| Version = 1.2
| ReleaseDate = {{1998S}}
| Company = N/A
| Published = {{Published}}
| Developers = {{JensChristianRestemeierToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{C}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}} (Included in download)
| License = {{NoLicense}}
| Platform = {{DOSTool}}
| Type = {{AGISoundResourceTool}}
| Localization = {{EnglishTool}}
| Website =
}}

{{Stub}}

<br />
==<br /><br /> Description ==

<blockquote>
[[Jens Christian Restemeier|Jens Christian Restemeier's]] SND2MIDI is a very simple program to convert an AGI Sound to MIDI.

{{TechToDo}}
</blockquote>


==<br /> Features ==

*

==<br /> Version History ==

<blockquote>
 
</blockquote>

==<br /> Development Status ==

<blockquote>
 
</blockquote>

==<br /> Usage ==

#

==<br /> Download ==

<blockquote>
'''Download from here:'''
* [[Image:ZIP.png|ZIP File]] [[File:AGI_SOUND_to_MIDI_(SND2MIDI).zip|AGI_SOUND_to_MIDI_(SND2MIDI).zip]] <span class="DLInfo"> (ZIP file) [24.7 KB] - (Source included)</span>
</blockquote>

== <br />Known issues ==

*

== <br />Credits ==

* [[Jens Christian Restemeier]]

==<br /> References ==

<references />

== Also See ==

* [[:Category:AGI Sound Tools|AGI Sound Tools]]
 
[[Category:AGI Sound Utilities]]

Adam Skawiński

2025-05-29T14:59:30Z

Sinus: /* Home Page */

{{ProfileStub}}
{{FanDesignerInfobox
| Portrait = {{MissingPortrait}}
| Name = Adam Skawiński
}}

==<br /> A.K.A. ==

* Adam 'Sinus' Skawiński


==<br /> About ==

<blockquote>

</blockquote>

==<br /> Home Page ==

* [https://www.facebook.com/sinus.pi Adam Skawiński on Facebook]

==<br /> Tools Developed by Adam Skawiński ==

<blockquote>
{| class="wikitable sortable" 
! width="400" | Title !! width="30" | Year !! width="400" | Credits
|- valign="top"
| [[Impulse Tracker to AGI Sound]] || align="center" |[[2025]] || Developer
|}
</blockquote>

==<br /> References ==

<references />

==<br /> See Also ==

* [[:Category:Tools Developed by Adam Skawiński|Tools Developed by Adam Skawiński]]
 
[[Category:Tool Developers]]
[[Category:AGI Tool Developers]]
[[Category:Fan Tool Developers]]
[[Category:Fan AGI Tool Developers]]

Adam Skawiński

2025-05-29T14:59:12Z

Sinus: /* See Also */

{{ProfileStub}}
{{FanDesignerInfobox
| Portrait = {{MissingPortrait}}
| Name = Adam Skawiński
}}

==<br /> A.K.A. ==

* Adam 'Sinus' Skawiński


==<br /> About ==

<blockquote>

</blockquote>

==<br /> Home Page ==

* [https://www.facebook.com/sinus.pi Adam Skawiński on Facebook]
* [[linkedin:adam-sowi%C5%84ski-84829a109|Adam Skawiński on LinkedIn]]

==<br /> Tools Developed by Adam Skawiński ==

<blockquote>
{| class="wikitable sortable" 
! width="400" | Title !! width="30" | Year !! width="400" | Credits
|- valign="top"
| [[Impulse Tracker to AGI Sound]] || align="center" |[[2025]] || Developer
|}
</blockquote>

==<br /> References ==

<references />

==<br /> See Also ==

* [[:Category:Tools Developed by Adam Skawiński|Tools Developed by Adam Skawiński]]
 
[[Category:Tool Developers]]
[[Category:AGI Tool Developers]]
[[Category:Fan Tool Developers]]
[[Category:Fan AGI Tool Developers]]

Adam Skawiński

2025-05-29T14:58:53Z

Sinus: /* See Also */

{{ProfileStub}}
{{FanDesignerInfobox
| Portrait = {{MissingPortrait}}
| Name = Adam Skawiński
}}

==<br /> A.K.A. ==

* Adam 'Sinus' Skawiński


==<br /> About ==

<blockquote>

</blockquote>

==<br /> Home Page ==

* [https://www.facebook.com/sinus.pi Adam Skawiński on Facebook]
* [[linkedin:adam-sowi%C5%84ski-84829a109|Adam Skawiński on LinkedIn]]

==<br /> Tools Developed by Adam Skawiński ==

<blockquote>
{| class="wikitable sortable" 
! width="400" | Title !! width="30" | Year !! width="400" | Credits
|- valign="top"
| [[Impulse Tracker to AGI Sound]] || align="center" |[[2025]] || Developer
|}
</blockquote>

==<br /> References ==

<references />

==<br /> See Also ==

* [[:Category:Tools Developed by Adam Skawiński|Tools Developed by Adam Skawiński]]
* [[w:Special:Search/Adam Skawiński|Search for Adam Skawiński on Wikipedia]]
* <span class="Inactive">Adam Skawiński on IMDb</span>
 
[[Category:Tool Developers]]
[[Category:AGI Tool Developers]]
[[Category:Fan Tool Developers]]
[[Category:Fan AGI Tool Developers]]

Adam Skawiński

2025-05-29T14:58:17Z

Sinus: /* Home Page */

{{ProfileStub}}
{{FanDesignerInfobox
| Portrait = {{MissingPortrait}}
| Name = Adam Skawiński
}}

==<br /> A.K.A. ==

* Adam 'Sinus' Skawiński


==<br /> About ==

<blockquote>

</blockquote>

==<br /> Home Page ==

* [https://www.facebook.com/sinus.pi Adam Skawiński on Facebook]
* [[linkedin:adam-sowi%C5%84ski-84829a109|Adam Skawiński on LinkedIn]]

==<br /> Tools Developed by Adam Skawiński ==

<blockquote>
{| class="wikitable sortable" 
! width="400" | Title !! width="30" | Year !! width="400" | Credits
|- valign="top"
| [[Impulse Tracker to AGI Sound]] || align="center" |[[2025]] || Developer
|}
</blockquote>

==<br /> References ==

<references />

==<br /> See Also ==

* [[:Category:Tools Developed by Adam Skawiński|Tools Developed by Adam Skawiński]]
* [[w:Special:Search/Adam Skawiński|Search for Adam Skawiński on Wikipedia]]
* [[mobydev:867683|Adam Skawiński on MobyGames]]
* <span class="Inactive">Adam Skawiński on IMDb</span>
 
[[Category:Tool Developers]]
[[Category:AGI Tool Developers]]
[[Category:Fan Tool Developers]]
[[Category:Fan AGI Tool Developers]]

Sinus' Branch of Impulse Tracker to AGI Sound

2025-05-29T14:57:14Z

Sinus: /* Download */

<div align="center"><div style="font-size: 22pt">Sinus's Branch of Impulse Tracker to AGI Sound</div><br />
Version 0.2.7<br />''Author: [[Adam Skawiński]] and [[Nat Budin]]''<br />2025</div>

{{FanAGISoftwareInfobox
| Software = Impulse Tracker to AGI Sound (Sinus)
| Image =
| Version = 0.2.7
| ReleaseDate = {{2025}}-05-19<ref>https://sciprogramming.com/community/index.php?topic=9284.0</ref>
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{AdamSkawińskiToolDev}}, {{NatBudinToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{Perl}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[https://github.com/SinusPi/any2agi Yes]
| License = {{NoLicense}}
| Type = {{FanAGISoundConverter}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}, {{LinuxTool}}
| Localization = {{EnglishTool}}
| Website = https://github.com/SinusPi/any2agi
}}

<br />
==<br /> A.K.A. ==

* '''''ANY2AGI'''''

==<br /> Description ==

<blockquote>
[[User:Sinus|Adam 'Sinus' Skawiński]]'s branch of [[Nat Budin]]'s [[Impulse Tracker to AGI Sound]] Perl script adds support for noise channel and more input formats (now: IT, MOD and MIDI), as well as some quality-of-life options.

The [https://www.perl.org/ Perl language runtime] is required to run. Input music files may be created with [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] (for DOS only), [https://openmpt.org OpenMPT] or any MIDI editor.
</blockquote>

==Features ==
Input formats:<blockquote>
* Impulse Tracker (.it)
* Protracker (.mod) - basic support only, no tempo support yet
* MIDI (.mid) - input needs to have monophonic tracks or channels, no tempo support yet</blockquote>

== Notes ==
The PCjr sound chip supports only 3 voices and 1 noise channel, so you'll have to use the first 4 channels of an IT file, or use --channels to cherry-pick.

Noise notes are: C-0 (high buzz), C#0 (mid buzz), D-0 (low buzz), D#0 (borrow buzz), C-1 (high noise), C#1 (mid noise), D-1 (low noise), D#1 (borrow noise). "Borrowed" notes play frequencies borrowed from the third channel, though not very precisely. They're good for special effects like explosions or zaps, though, if you play a series of appropriate notes on channel 3 (probably with a volume of 0).

On PC Speaker, only the first channel will be used, other channels will be ignored. Keep that in mind when making your input files. Of course you can also make two separate files, one monophonic for PC Speaker, and one multichannel for PCjr, and play them appropriately from within your game, by checking AGI var 22 - but watch out for memory limits.

If you're writing an IT file from scratch, set tempo to 150 and speed to 1. This will give you a perfect match for the AGI engine's 60 ticks per second, and 16.67 ms per tick.

== Requirements ==

<blockquote>
* [https://www.perl.org/ Perl language runtime]
* [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] (for DOS only) or [https://openmpt.org/ OpenMPT]
</blockquote>

==Usage ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>

The script will produce a file called "<name>.ags".
</blockquote>

==Options ==

<blockquote>
* <code>--channels x,x,x,y</code> - select input channels. Default is <code>--channels 1,2,3,4</code> to output first four channels, with the last being used as noise. <code>--channels 1,2,3</code> would simply omit the noise channel. You'll probably have to use this to pick channels out of multi-channel input files, or rearrange them to put the noise channel last. Midi channels are numbered from 0.

* <code>--tempo-exact</code> - force exact tempo, at the cost of jittery playback. AGI engine plays using 1/60s ticks, so any playback must either use equal note lengths (at the cost of a different BPM from the original - by default), or try to match the original's BPM exactly by using varied note lengths. MIDI conversion uses exact tempo matching only.
* <code>--auto-drum-offs n</code> - automatically terminate notes on the noise channel after <code>n</code> ticks. Useful when converting input files that use short samples and don't bother terminating them, which would turn into long noise notes in AGI.
* <code>--instr-note x y</code> - force instrument <code>x</code> to play only note <code>y</code> . Useful to force a drum-like instrument to play only valid AGI drum notes. Typical notes are 13 (high noise), 14 (middle noise) and 15 (low noise). Combined with <code>--channels</code> to properly map an input channel to the noise output, and <code>--auto-drum-offs</code> to make output drums shorter, this option can turn a typical "rhythm channel" in the input into proper noise channel output for AGI.
* <code>--instr-shift x y</code> - shift (transpose) instrument <code>x</code> by <code>y</code> semitones. Use when input samples were recorded in a weird pitch, and notes in the input were written to match that. Or, use +12 or -12 to transpose by an octave.</blockquote>

== Version History ==

* ''0.2.1: Added recognizing MOD, S3M and XM modules, and MIDI files. They're not (yet?) supported, but recognized.''

* ''0.2.2: Experimental option --channels added''
* ''0.2.3: Tempo mode added: --tempo-exact''
* ''0.2.4: Auto drum note-offs added: --auto-drum-offs 1/2/3...''
* ''0.2.5: very basic MOD and MIDI support added''
* ''0.2.6: --auto-drum-offs now use AGI ticks for scale, not rows;'' ''--instr-drum'' ''added''
* ''0.2.7: --instr-drum changed to --instr-note, and'' ''--instr-oct to --instr-shift''
== Development Status ==

<blockquote>
Last updated: 2025-05-29.
</blockquote>

== Download ==

<blockquote>
Download from here:
* v0.2.2 [[Image:ZIP.png|ZIP File]] [[File:Impulse_Tracker_to_AGI_Sound_(ANY2AGI022).zip|IImpulse Tracker to_AGI Sound 0.2.3 (ANY2AGI022).zip]] <span class="DLInfo"> (ZIP file) [6.24 KB]</span>
* Newest: [[github:SinusPi/any2agi|SinusPi/any2agi on GitHub]]
</blockquote>

==<br /> Known issues ==

# IT2AGI doesn't (yet) support changing tempo or speed in the middle of the song. Don't try this, as it will be cruelly ignored.
# Several other music formats (S3M, XM) are recognized, but not supported.
# Finally, AGI is very limited in what it can do. If AGI doesn't support something, IT2AGI most likely doesn't either.

==<br /> Credits ==

* [[Adam Skawiński]]
* [[Nat Budin]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Sound Converters|AGI Sound Converters]]
* [[AGI Specifications: Chapter 9 - Sound Resources]]
 
[[Category:Sound Converters]]
[[Category:AGI Sound Converters]]

Sinus' Branch of Impulse Tracker to AGI Sound

2025-05-29T14:54:37Z

Sinus: /* Requirements */

<div align="center"><div style="font-size: 22pt">Sinus's Branch of Impulse Tracker to AGI Sound</div><br />
Version 0.2.7<br />''Author: [[Adam Skawiński]] and [[Nat Budin]]''<br />2025</div>

{{FanAGISoftwareInfobox
| Software = Impulse Tracker to AGI Sound (Sinus)
| Image =
| Version = 0.2.7
| ReleaseDate = {{2025}}-05-19<ref>https://sciprogramming.com/community/index.php?topic=9284.0</ref>
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{AdamSkawińskiToolDev}}, {{NatBudinToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{Perl}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[https://github.com/SinusPi/any2agi Yes]
| License = {{NoLicense}}
| Type = {{FanAGISoundConverter}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}, {{LinuxTool}}
| Localization = {{EnglishTool}}
| Website = https://github.com/SinusPi/any2agi
}}

<br />
==<br /> A.K.A. ==

* '''''ANY2AGI'''''

==<br /> Description ==

<blockquote>
[[User:Sinus|Adam 'Sinus' Skawiński]]'s branch of [[Nat Budin]]'s [[Impulse Tracker to AGI Sound]] Perl script adds support for noise channel and more input formats (now: IT, MOD and MIDI), as well as some quality-of-life options.

The [https://www.perl.org/ Perl language runtime] is required to run. Input music files may be created with [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] (for DOS only), [https://openmpt.org OpenMPT] or any MIDI editor.
</blockquote>

==Features ==
Input formats:<blockquote>
* Impulse Tracker (.it)
* Protracker (.mod) - basic support only, no tempo support yet
* MIDI (.mid) - input needs to have monophonic tracks or channels, no tempo support yet</blockquote>

== Notes ==
The PCjr sound chip supports only 3 voices and 1 noise channel, so you'll have to use the first 4 channels of an IT file, or use --channels to cherry-pick.

Noise notes are: C-0 (high buzz), C#0 (mid buzz), D-0 (low buzz), D#0 (borrow buzz), C-1 (high noise), C#1 (mid noise), D-1 (low noise), D#1 (borrow noise). "Borrowed" notes play frequencies borrowed from the third channel, though not very precisely. They're good for special effects like explosions or zaps, though, if you play a series of appropriate notes on channel 3 (probably with a volume of 0).

On PC Speaker, only the first channel will be used, other channels will be ignored. Keep that in mind when making your input files. Of course you can also make two separate files, one monophonic for PC Speaker, and one multichannel for PCjr, and play them appropriately from within your game, by checking AGI var 22 - but watch out for memory limits.

If you're writing an IT file from scratch, set tempo to 150 and speed to 1. This will give you a perfect match for the AGI engine's 60 ticks per second, and 16.67 ms per tick.

== Requirements ==

<blockquote>
* [https://www.perl.org/ Perl language runtime]
* [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] (for DOS only) or [https://openmpt.org/ OpenMPT]
</blockquote>

==Usage ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>

The script will produce a file called "<name>.ags".
</blockquote>

==Options ==

<blockquote>
* <code>--channels x,x,x,y</code> - select input channels. Default is <code>--channels 1,2,3,4</code> to output first four channels, with the last being used as noise. <code>--channels 1,2,3</code> would simply omit the noise channel. You'll probably have to use this to pick channels out of multi-channel input files, or rearrange them to put the noise channel last. Midi channels are numbered from 0.

* <code>--tempo-exact</code> - force exact tempo, at the cost of jittery playback. AGI engine plays using 1/60s ticks, so any playback must either use equal note lengths (at the cost of a different BPM from the original - by default), or try to match the original's BPM exactly by using varied note lengths. MIDI conversion uses exact tempo matching only.
* <code>--auto-drum-offs n</code> - automatically terminate notes on the noise channel after <code>n</code> ticks. Useful when converting input files that use short samples and don't bother terminating them, which would turn into long noise notes in AGI.
* <code>--instr-note x y</code> - force instrument <code>x</code> to play only note <code>y</code> . Useful to force a drum-like instrument to play only valid AGI drum notes. Typical notes are 13 (high noise), 14 (middle noise) and 15 (low noise). Combined with <code>--channels</code> to properly map an input channel to the noise output, and <code>--auto-drum-offs</code> to make output drums shorter, this option can turn a typical "rhythm channel" in the input into proper noise channel output for AGI.
* <code>--instr-shift x y</code> - shift (transpose) instrument <code>x</code> by <code>y</code> semitones. Use when input samples were recorded in a weird pitch, and notes in the input were written to match that. Or, use +12 or -12 to transpose by an octave.</blockquote>

== Version History ==

* ''0.2.1: Added recognizing MOD, S3M and XM modules, and MIDI files. They're not (yet?) supported, but recognized.''

* ''0.2.2: Experimental option --channels added''
* ''0.2.3: Tempo mode added: --tempo-exact''
* ''0.2.4: Auto drum note-offs added: --auto-drum-offs 1/2/3...''
* ''0.2.5: very basic MOD and MIDI support added''
* ''0.2.6: --auto-drum-offs now use AGI ticks for scale, not rows;'' ''--instr-drum'' ''added''
* ''0.2.7: --instr-drum changed to --instr-note, and'' ''--instr-oct to --instr-shift''
== Development Status ==

<blockquote>
Last updated: 2025-05-29.
</blockquote>

== Download ==

<blockquote>
Download from here:
* <div id="DL">[[Image:ZIP.png|ZIP File]] [[File:Impulse_Tracker_to_AGI_Sound_(ANY2AGI022).zip|IImpulse Tracker to_AGI Sound 0.2.3 (ANY2AGI022).zip]] <span class="DLInfo"> (ZIP file) [6.24 KB]</span><br /><br />'''GitHub:'''
<blockquote>
* [[github:SinusPi/any2agi|SinusPi/any2agi on GitHub]]
</blockquote>
</blockquote>

==<br /> Known issues ==

# IT2AGI doesn't (yet) support changing tempo or speed in the middle of the song. Don't try this, as it will be cruelly ignored.
# Finally, AGI is very limited in what it can do. If AGI doesn't support something, IT2AGI most likely doesn't either.

==<br /> Credits ==

* [[Adam Skawiński]]
* [[Nat Budin]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Sound Converters|AGI Sound Converters]]
* [[AGI Specifications: Chapter 9 - Sound Resources]]
 
[[Category:Sound Converters]]
[[Category:AGI Sound Converters]]

Sinus' Branch of Impulse Tracker to AGI Sound

2025-05-29T14:51:55Z

Sinus: /* Description */

<div align="center"><div style="font-size: 22pt">Sinus's Branch of Impulse Tracker to AGI Sound</div><br />
Version 0.2.7<br />''Author: [[Adam Skawiński]] and [[Nat Budin]]''<br />2025</div>

{{FanAGISoftwareInfobox
| Software = Impulse Tracker to AGI Sound (Sinus)
| Image =
| Version = 0.2.7
| ReleaseDate = {{2025}}-05-19<ref>https://sciprogramming.com/community/index.php?topic=9284.0</ref>
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{AdamSkawińskiToolDev}}, {{NatBudinToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{Perl}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[https://github.com/SinusPi/any2agi Yes]
| License = {{NoLicense}}
| Type = {{FanAGISoundConverter}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}, {{LinuxTool}}
| Localization = {{EnglishTool}}
| Website = https://github.com/SinusPi/any2agi
}}

<br />
==<br /> A.K.A. ==

* '''''ANY2AGI'''''

==<br /> Description ==

<blockquote>
[[User:Sinus|Adam 'Sinus' Skawiński]]'s branch of [[Nat Budin]]'s [[Impulse Tracker to AGI Sound]] Perl script adds support for noise channel and more input formats (now: IT, MOD and MIDI), as well as some quality-of-life options.

The [https://www.perl.org/ Perl language runtime] is required to run. Input music files may be created with [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] (for DOS only), [https://openmpt.org OpenMPT] or any MIDI editor.
</blockquote>

==Features ==
Input formats:<blockquote>
* Impulse Tracker (.it)
* Protracker (.mod) - basic support only, no tempo support yet
* MIDI (.mid) - input needs to have monophonic tracks or channels, no tempo support yet</blockquote>

== Notes ==
The PCjr sound chip supports only 3 voices and 1 noise channel, so you'll have to use the first 4 channels of an IT file, or use --channels to cherry-pick.

Noise notes are: C-0 (high buzz), C#0 (mid buzz), D-0 (low buzz), D#0 (borrow buzz), C-1 (high noise), C#1 (mid noise), D-1 (low noise), D#1 (borrow noise). "Borrowed" notes play frequencies borrowed from the third channel, though not very precisely. They're good for special effects like explosions or zaps, though, if you play a series of appropriate notes on channel 3 (probably with a volume of 0).

On PC Speaker, only the first channel will be used, other channels will be ignored. Keep that in mind when making your input files. Of course you can also make two separate files, one monophonic for PC Speaker, and one multichannel for PCjr, and play them appropriately from within your game, by checking AGI var 22 - but watch out for memory limits.

If you're writing an IT file from scratch, set tempo to 150 and speed to 1. This will give you a perfect match for the AGI engine's 60 ticks per second, and 16.67 ms per tick.

== Requirements ==

<blockquote>
* [https://www.perl.org/ Perl runtime]
* [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] or [https://openmpt.org/ OpenMPT]
</blockquote>

==Usage ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>

The script will produce a file called "<name>.ags".
</blockquote>

==Options ==

<blockquote>
* <code>--channels x,x,x,y</code> - select input channels. Default is <code>--channels 1,2,3,4</code> to output first four channels, with the last being used as noise. <code>--channels 1,2,3</code> would simply omit the noise channel. You'll probably have to use this to pick channels out of multi-channel input files, or rearrange them to put the noise channel last. Midi channels are numbered from 0.

* <code>--tempo-exact</code> - force exact tempo, at the cost of jittery playback. AGI engine plays using 1/60s ticks, so any playback must either use equal note lengths (at the cost of a different BPM from the original - by default), or try to match the original's BPM exactly by using varied note lengths. MIDI conversion uses exact tempo matching only.
* <code>--auto-drum-offs n</code> - automatically terminate notes on the noise channel after <code>n</code> ticks. Useful when converting input files that use short samples and don't bother terminating them, which would turn into long noise notes in AGI.
* <code>--instr-note x y</code> - force instrument <code>x</code> to play only note <code>y</code> . Useful to force a drum-like instrument to play only valid AGI drum notes. Typical notes are 13 (high noise), 14 (middle noise) and 15 (low noise). Combined with <code>--channels</code> to properly map an input channel to the noise output, and <code>--auto-drum-offs</code> to make output drums shorter, this option can turn a typical "rhythm channel" in the input into proper noise channel output for AGI.
* <code>--instr-shift x y</code> - shift (transpose) instrument <code>x</code> by <code>y</code> semitones. Use when input samples were recorded in a weird pitch, and notes in the input were written to match that. Or, use +12 or -12 to transpose by an octave.</blockquote>

== Version History ==

* ''0.2.1: Added recognizing MOD, S3M and XM modules, and MIDI files. They're not (yet?) supported, but recognized.''

* ''0.2.2: Experimental option --channels added''
* ''0.2.3: Tempo mode added: --tempo-exact''
* ''0.2.4: Auto drum note-offs added: --auto-drum-offs 1/2/3...''
* ''0.2.5: very basic MOD and MIDI support added''
* ''0.2.6: --auto-drum-offs now use AGI ticks for scale, not rows;'' ''--instr-drum'' ''added''
* ''0.2.7: --instr-drum changed to --instr-note, and'' ''--instr-oct to --instr-shift''
== Development Status ==

<blockquote>
Last updated: 2025-05-29.
</blockquote>

== Download ==

<blockquote>
Download from here:
* <div id="DL">[[Image:ZIP.png|ZIP File]] [[File:Impulse_Tracker_to_AGI_Sound_(ANY2AGI022).zip|IImpulse Tracker to_AGI Sound 0.2.3 (ANY2AGI022).zip]] <span class="DLInfo"> (ZIP file) [6.24 KB]</span><br /><br />'''GitHub:'''
<blockquote>
* [[github:SinusPi/any2agi|SinusPi/any2agi on GitHub]]
</blockquote>
</blockquote>

==<br /> Known issues ==

# IT2AGI doesn't (yet) support changing tempo or speed in the middle of the song. Don't try this, as it will be cruelly ignored.
# Finally, AGI is very limited in what it can do. If AGI doesn't support something, IT2AGI most likely doesn't either.

==<br /> Credits ==

* [[Adam Skawiński]]
* [[Nat Budin]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Sound Converters|AGI Sound Converters]]
* [[AGI Specifications: Chapter 9 - Sound Resources]]
 
[[Category:Sound Converters]]
[[Category:AGI Sound Converters]]

Sinus' Branch of Impulse Tracker to AGI Sound

2025-05-29T14:49:17Z

Sinus: /* Features */

<div align="center"><div style="font-size: 22pt">Sinus's Branch of Impulse Tracker to AGI Sound</div><br />
Version 0.2.7<br />''Author: [[Adam Skawiński]] and [[Nat Budin]]''<br />2025</div>

{{FanAGISoftwareInfobox
| Software = Impulse Tracker to AGI Sound (Sinus)
| Image =
| Version = 0.2.7
| ReleaseDate = {{2025}}-05-19<ref>https://sciprogramming.com/community/index.php?topic=9284.0</ref>
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{AdamSkawińskiToolDev}}, {{NatBudinToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{Perl}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[https://github.com/SinusPi/any2agi Yes]
| License = {{NoLicense}}
| Type = {{FanAGISoundConverter}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}, {{LinuxTool}}
| Localization = {{EnglishTool}}
| Website = https://github.com/SinusPi/any2agi
}}

<br />
==<br /> A.K.A. ==

* '''''ANY2AGI'''''

==<br /> Description ==

<blockquote>
[[User:Sinus|Adam 'Sinus' Skawiński]]'s branch of [[Nat Budin]]'s [[Impulse Tracker to AGI Sound]] Perl script adds support for noise channel and more input formats (now: IT, MOD and MIDI), as well as some quality-of-life options.

The [https://www.perl.org/ Perl language runtime] is required to run. Input music files may be created with [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker], [https://openmpt.org OpenMPT] or any MIDI editor.
</blockquote>

==Features ==
Input formats:<blockquote>
* Impulse Tracker (.it)
* Protracker (.mod) - basic support only, no tempo support yet
* MIDI (.mid) - input needs to have monophonic tracks or channels, no tempo support yet</blockquote>

== Notes ==
The PCjr sound chip supports only 3 voices and 1 noise channel, so you'll have to use the first 4 channels of an IT file, or use --channels to cherry-pick.

Noise notes are: C-0 (high buzz), C#0 (mid buzz), D-0 (low buzz), D#0 (borrow buzz), C-1 (high noise), C#1 (mid noise), D-1 (low noise), D#1 (borrow noise). "Borrowed" notes play frequencies borrowed from the third channel, though not very precisely. They're good for special effects like explosions or zaps, though, if you play a series of appropriate notes on channel 3 (probably with a volume of 0).

On PC Speaker, only the first channel will be used, other channels will be ignored. Keep that in mind when making your input files. Of course you can also make two separate files, one monophonic for PC Speaker, and one multichannel for PCjr, and play them appropriately from within your game, by checking AGI var 22 - but watch out for memory limits.

If you're writing an IT file from scratch, set tempo to 150 and speed to 1. This will give you a perfect match for the AGI engine's 60 ticks per second, and 16.67 ms per tick.

== Requirements ==

<blockquote>
* [https://www.perl.org/ Perl runtime]
* [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] or [https://openmpt.org/ OpenMPT]
</blockquote>

==Usage ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>

The script will produce a file called "<name>.ags".
</blockquote>

==Options ==

<blockquote>
* <code>--channels x,x,x,y</code> - select input channels. Default is <code>--channels 1,2,3,4</code> to output first four channels, with the last being used as noise. <code>--channels 1,2,3</code> would simply omit the noise channel. You'll probably have to use this to pick channels out of multi-channel input files, or rearrange them to put the noise channel last. Midi channels are numbered from 0.

* <code>--tempo-exact</code> - force exact tempo, at the cost of jittery playback. AGI engine plays using 1/60s ticks, so any playback must either use equal note lengths (at the cost of a different BPM from the original - by default), or try to match the original's BPM exactly by using varied note lengths. MIDI conversion uses exact tempo matching only.
* <code>--auto-drum-offs n</code> - automatically terminate notes on the noise channel after <code>n</code> ticks. Useful when converting input files that use short samples and don't bother terminating them, which would turn into long noise notes in AGI.
* <code>--instr-note x y</code> - force instrument <code>x</code> to play only note <code>y</code> . Useful to force a drum-like instrument to play only valid AGI drum notes. Typical notes are 13 (high noise), 14 (middle noise) and 15 (low noise). Combined with <code>--channels</code> to properly map an input channel to the noise output, and <code>--auto-drum-offs</code> to make output drums shorter, this option can turn a typical "rhythm channel" in the input into proper noise channel output for AGI.
* <code>--instr-shift x y</code> - shift (transpose) instrument <code>x</code> by <code>y</code> semitones. Use when input samples were recorded in a weird pitch, and notes in the input were written to match that. Or, use +12 or -12 to transpose by an octave.</blockquote>

== Version History ==

* ''0.2.1: Added recognizing MOD, S3M and XM modules, and MIDI files. They're not (yet?) supported, but recognized.''

* ''0.2.2: Experimental option --channels added''
* ''0.2.3: Tempo mode added: --tempo-exact''
* ''0.2.4: Auto drum note-offs added: --auto-drum-offs 1/2/3...''
* ''0.2.5: very basic MOD and MIDI support added''
* ''0.2.6: --auto-drum-offs now use AGI ticks for scale, not rows;'' ''--instr-drum'' ''added''
* ''0.2.7: --instr-drum changed to --instr-note, and'' ''--instr-oct to --instr-shift''
== Development Status ==

<blockquote>
Last updated: 2025-05-29.
</blockquote>

== Download ==

<blockquote>
Download from here:
* <div id="DL">[[Image:ZIP.png|ZIP File]] [[File:Impulse_Tracker_to_AGI_Sound_(ANY2AGI022).zip|IImpulse Tracker to_AGI Sound 0.2.3 (ANY2AGI022).zip]] <span class="DLInfo"> (ZIP file) [6.24 KB]</span><br /><br />'''GitHub:'''
<blockquote>
* [[github:SinusPi/any2agi|SinusPi/any2agi on GitHub]]
</blockquote>
</blockquote>

==<br /> Known issues ==

# IT2AGI doesn't (yet) support changing tempo or speed in the middle of the song. Don't try this, as it will be cruelly ignored.
# Finally, AGI is very limited in what it can do. If AGI doesn't support something, IT2AGI most likely doesn't either.

==<br /> Credits ==

* [[Adam Skawiński]]
* [[Nat Budin]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Sound Converters|AGI Sound Converters]]
* [[AGI Specifications: Chapter 9 - Sound Resources]]
 
[[Category:Sound Converters]]
[[Category:AGI Sound Converters]]

Sinus' Branch of Impulse Tracker to AGI Sound

2025-05-29T14:47:00Z

Sinus: /* Notes */

<div align="center"><div style="font-size: 22pt">Sinus's Branch of Impulse Tracker to AGI Sound</div><br />
Version 0.2.7<br />''Author: [[Adam Skawiński]] and [[Nat Budin]]''<br />2025</div>

{{FanAGISoftwareInfobox
| Software = Impulse Tracker to AGI Sound (Sinus)
| Image =
| Version = 0.2.7
| ReleaseDate = {{2025}}-05-19<ref>https://sciprogramming.com/community/index.php?topic=9284.0</ref>
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{AdamSkawińskiToolDev}}, {{NatBudinToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{Perl}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[https://github.com/SinusPi/any2agi Yes]
| License = {{NoLicense}}
| Type = {{FanAGISoundConverter}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}, {{LinuxTool}}
| Localization = {{EnglishTool}}
| Website = https://github.com/SinusPi/any2agi
}}

<br />
==<br /> A.K.A. ==

* '''''ANY2AGI'''''

==<br /> Description ==

<blockquote>
[[User:Sinus|Adam 'Sinus' Skawiński]]'s branch of [[Nat Budin]]'s [[Impulse Tracker to AGI Sound]] Perl script adds support for noise channel and more input formats (now: IT, MOD and MIDI), as well as some quality-of-life options.

The [https://www.perl.org/ Perl language runtime] is required to run. Input music files may be created with [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker], [https://openmpt.org OpenMPT] or any MIDI editor.
</blockquote>

==Features ==

=== Input formats: ===
<blockquote>
* Impulse Tracker (.it)
* Protracker (.mod) - basic support only, no tempo support yet
* MIDI (.mid) - input needs to have monophonic tracks or channels, no tempo support yet</blockquote>

== Notes ==
The PCjr sound chip supports only 3 voices and 1 noise channel, so you'll have to use the first 4 channels of an IT file, or use --channels to cherry-pick.

Noise notes are: C-0 (high buzz), C#0 (mid buzz), D-0 (low buzz), D#0 (borrow buzz), C-1 (high noise), C#1 (mid noise), D-1 (low noise), D#1 (borrow noise). "Borrowed" notes play frequencies borrowed from the third channel, though not very precisely. They're good for special effects like explosions or zaps, though, if you play a series of appropriate notes on channel 3 (probably with a volume of 0).

On PC Speaker, only the first channel will be used, other channels will be ignored. Keep that in mind when making your input files. Of course you can also make two separate files, one monophonic for PC Speaker, and one multichannel for PCjr, and play them appropriately from within your game, by checking AGI var 22 - but watch out for memory limits.

If you're writing an IT file from scratch, set tempo to 150 and speed to 1. This will give you a perfect match for the AGI engine's 60 ticks per second, and 16.67 ms per tick.

== Requirements ==

<blockquote>
* [https://www.perl.org/ Perl runtime]
* [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] or [https://openmpt.org/ OpenMPT]
</blockquote>

==Usage ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>

The script will produce a file called "<name>.ags".
</blockquote>

==Options ==

<blockquote>
* <code>--channels x,x,x,y</code> - select input channels. Default is <code>--channels 1,2,3,4</code> to output first four channels, with the last being used as noise. <code>--channels 1,2,3</code> would simply omit the noise channel. You'll probably have to use this to pick channels out of multi-channel input files, or rearrange them to put the noise channel last. Midi channels are numbered from 0.

* <code>--tempo-exact</code> - force exact tempo, at the cost of jittery playback. AGI engine plays using 1/60s ticks, so any playback must either use equal note lengths (at the cost of a different BPM from the original - by default), or try to match the original's BPM exactly by using varied note lengths. MIDI conversion uses exact tempo matching only.
* <code>--auto-drum-offs n</code> - automatically terminate notes on the noise channel after <code>n</code> ticks. Useful when converting input files that use short samples and don't bother terminating them, which would turn into long noise notes in AGI.
* <code>--instr-note x y</code> - force instrument <code>x</code> to play only note <code>y</code> . Useful to force a drum-like instrument to play only valid AGI drum notes. Typical notes are 13 (high noise), 14 (middle noise) and 15 (low noise). Combined with <code>--channels</code> to properly map an input channel to the noise output, and <code>--auto-drum-offs</code> to make output drums shorter, this option can turn a typical "rhythm channel" in the input into proper noise channel output for AGI.
* <code>--instr-shift x y</code> - shift (transpose) instrument <code>x</code> by <code>y</code> semitones. Use when input samples were recorded in a weird pitch, and notes in the input were written to match that. Or, use +12 or -12 to transpose by an octave.</blockquote>

== Version History ==

* ''0.2.1: Added recognizing MOD, S3M and XM modules, and MIDI files. They're not (yet?) supported, but recognized.''

* ''0.2.2: Experimental option --channels added''
* ''0.2.3: Tempo mode added: --tempo-exact''
* ''0.2.4: Auto drum note-offs added: --auto-drum-offs 1/2/3...''
* ''0.2.5: very basic MOD and MIDI support added''
* ''0.2.6: --auto-drum-offs now use AGI ticks for scale, not rows;'' ''--instr-drum'' ''added''
* ''0.2.7: --instr-drum changed to --instr-note, and'' ''--instr-oct to --instr-shift''
== Development Status ==

<blockquote>
Last updated: 2025-05-29.
</blockquote>

== Download ==

<blockquote>
Download from here:
* <div id="DL">[[Image:ZIP.png|ZIP File]] [[File:Impulse_Tracker_to_AGI_Sound_(ANY2AGI022).zip|IImpulse Tracker to_AGI Sound 0.2.3 (ANY2AGI022).zip]] <span class="DLInfo"> (ZIP file) [6.24 KB]</span><br /><br />'''GitHub:'''
<blockquote>
* [[github:SinusPi/any2agi|SinusPi/any2agi on GitHub]]
</blockquote>
</blockquote>

==<br /> Known issues ==

# IT2AGI doesn't (yet) support changing tempo or speed in the middle of the song. Don't try this, as it will be cruelly ignored.
# Finally, AGI is very limited in what it can do. If AGI doesn't support something, IT2AGI most likely doesn't either.

==<br /> Credits ==

* [[Adam Skawiński]]
* [[Nat Budin]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Sound Converters|AGI Sound Converters]]
* [[AGI Specifications: Chapter 9 - Sound Resources]]
 
[[Category:Sound Converters]]
[[Category:AGI Sound Converters]]

Sinus' Branch of Impulse Tracker to AGI Sound

2025-05-29T14:29:54Z

Sinus: /* Notes */

<div align="center"><div style="font-size: 22pt">Sinus's Branch of Impulse Tracker to AGI Sound</div><br />
Version 0.2.7<br />''Author: [[Adam Skawiński]] and [[Nat Budin]]''<br />2025</div>

{{FanAGISoftwareInfobox
| Software = Impulse Tracker to AGI Sound (Sinus)
| Image =
| Version = 0.2.7
| ReleaseDate = {{2025}}-05-19<ref>https://sciprogramming.com/community/index.php?topic=9284.0</ref>
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{AdamSkawińskiToolDev}}, {{NatBudinToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{Perl}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[https://github.com/SinusPi/any2agi Yes]
| License = {{NoLicense}}
| Type = {{FanAGISoundConverter}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}, {{LinuxTool}}
| Localization = {{EnglishTool}}
| Website = https://github.com/SinusPi/any2agi
}}

<br />
==<br /> A.K.A. ==

* '''''ANY2AGI'''''

==<br /> Description ==

<blockquote>
[[User:Sinus|Adam 'Sinus' Skawiński]]'s branch of [[Nat Budin]]'s [[Impulse Tracker to AGI Sound]] Perl script adds support for noise channel and more input formats (now: IT, MOD and MIDI), as well as some quality-of-life options.

The [https://www.perl.org/ Perl language runtime] is required to run. Input music files may be created with [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker], [https://openmpt.org OpenMPT] or any MIDI editor.
</blockquote>

==Features ==

=== Input formats: ===
<blockquote>
* Impulse Tracker (.it)
* Protracker (.mod) - basic support only, no tempo support yet
* MIDI (.mid) - input needs to have monophonic tracks or channels, no tempo support yet</blockquote>

== Notes ==
The PCjr sound chip supports only 3 voices and 1 noise channel, so you'll have to use the first 4 channels of an IT file, or use --channels to cherry-pick.

Noise notes are: C-0 (high buzz), C#0 (mid buzz), D-0 (low buzz), D#0 (borrow buzz), C-1 (high noise), C#1 (mid noise), D-1 (low noise), D#1 (borrow noise). "Borrowed" notes play frequencies borrowed from the third channel, though not very precisely. They're good for special effects like explosions or zaps, though, if you play a series of appropriate notes on channel 3 (probably with a volume of 0).

On PC Speaker, only the first channel will be used, other channels will be ignored. Keep that in mind when making your input files. Of course you can also make two separate files, one monophonic for PC Speaker, and one multichannel for PCjr, and play them appropriately from within your game, by checking AGI var 22 - but watch out for memory limits.

== Requirements ==

<blockquote>
* [https://www.perl.org/ Perl runtime]
* [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] or [https://openmpt.org/ OpenMPT]
</blockquote>

==Usage ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>

The script will produce a file called "<name>.ags".
</blockquote>

==Options ==

<blockquote>
* <code>--channels x,x,x,y</code> - select input channels. Default is <code>--channels 1,2,3,4</code> to output first four channels, with the last being used as noise. <code>--channels 1,2,3</code> would simply omit the noise channel. You'll probably have to use this to pick channels out of multi-channel input files, or rearrange them to put the noise channel last. Midi channels are numbered from 0.

* <code>--tempo-exact</code> - force exact tempo, at the cost of jittery playback. AGI engine plays using 1/60s ticks, so any playback must either use equal note lengths (at the cost of a different BPM from the original - by default), or try to match the original's BPM exactly by using varied note lengths. MIDI conversion uses exact tempo matching only.
* <code>--auto-drum-offs n</code> - automatically terminate notes on the noise channel after <code>n</code> ticks. Useful when converting input files that use short samples and don't bother terminating them, which would turn into long noise notes in AGI.
* <code>--instr-note x y</code> - force instrument <code>x</code> to play only note <code>y</code> . Useful to force a drum-like instrument to play only valid AGI drum notes. Typical notes are 13 (high noise), 14 (middle noise) and 15 (low noise). Combined with <code>--channels</code> to properly map an input channel to the noise output, and <code>--auto-drum-offs</code> to make output drums shorter, this option can turn a typical "rhythm channel" in the input into proper noise channel output for AGI.
* <code>--instr-shift x y</code> - shift (transpose) instrument <code>x</code> by <code>y</code> semitones. Use when input samples were recorded in a weird pitch, and notes in the input were written to match that. Or, use +12 or -12 to transpose by an octave.</blockquote>

== Version History ==

* ''0.2.1: Added recognizing MOD, S3M and XM modules, and MIDI files. They're not (yet?) supported, but recognized.''

* ''0.2.2: Experimental option --channels added''
* ''0.2.3: Tempo mode added: --tempo-exact''
* ''0.2.4: Auto drum note-offs added: --auto-drum-offs 1/2/3...''
* ''0.2.5: very basic MOD and MIDI support added''
* ''0.2.6: --auto-drum-offs now use AGI ticks for scale, not rows;'' ''--instr-drum'' ''added''
* ''0.2.7: --instr-drum changed to --instr-note, and'' ''--instr-oct to --instr-shift''
== Development Status ==

<blockquote>
Last updated: 2025-05-29.
</blockquote>

== Download ==

<blockquote>
Download from here:
* <div id="DL">[[Image:ZIP.png|ZIP File]] [[File:Impulse_Tracker_to_AGI_Sound_(ANY2AGI022).zip|IImpulse Tracker to_AGI Sound 0.2.3 (ANY2AGI022).zip]] <span class="DLInfo"> (ZIP file) [6.24 KB]</span><br /><br />'''GitHub:'''
<blockquote>
* [[github:SinusPi/any2agi|SinusPi/any2agi on GitHub]]
</blockquote>
</blockquote>

==<br /> Known issues ==

# IT2AGI doesn't (yet) support changing tempo or speed in the middle of the song. Don't try this, as it will be cruelly ignored.
# Finally, AGI is very limited in what it can do. If AGI doesn't support something, IT2AGI most likely doesn't either.

==<br /> Credits ==

* [[Adam Skawiński]]
* [[Nat Budin]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Sound Converters|AGI Sound Converters]]
* [[AGI Specifications: Chapter 9 - Sound Resources]]
 
[[Category:Sound Converters]]
[[Category:AGI Sound Converters]]

Sinus' Branch of Impulse Tracker to AGI Sound

2025-05-29T14:25:22Z

Sinus: more edits

<div align="center"><div style="font-size: 22pt">Sinus's Branch of Impulse Tracker to AGI Sound</div><br />
Version 0.2.7<br />''Author: [[Adam Skawiński]] and [[Nat Budin]]''<br />2025</div>

{{FanAGISoftwareInfobox
| Software = Impulse Tracker to AGI Sound (Sinus)
| Image =
| Version = 0.2.7
| ReleaseDate = {{2025}}-05-19<ref>https://sciprogramming.com/community/index.php?topic=9284.0</ref>
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{AdamSkawińskiToolDev}}, {{NatBudinToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{Perl}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[https://github.com/SinusPi/any2agi Yes]
| License = {{NoLicense}}
| Type = {{FanAGISoundConverter}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}, {{LinuxTool}}
| Localization = {{EnglishTool}}
| Website = https://github.com/SinusPi/any2agi
}}

<br />
==<br /> A.K.A. ==

* '''''ANY2AGI'''''

==<br /> Description ==

<blockquote>
[[User:Sinus|Adam 'Sinus' Skawiński]]'s branch of [[Nat Budin]]'s [[Impulse Tracker to AGI Sound]] Perl script adds support for noise channel and more input formats (now: IT, MOD and MIDI), as well as some quality-of-life options.

The [https://www.perl.org/ Perl language runtime] is required to run. Input music files may be created with [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker], [https://openmpt.org OpenMPT] or any MIDI editor.
</blockquote>

==Features ==

=== Input formats: ===
<blockquote>
* Impulse Tracker (.it)
* Protracker (.mod) - basic support only, no tempo support yet
* MIDI (.mid) - input needs to have monophonic tracks or channels, no tempo support yet</blockquote>

== Notes ==
The PCjr sound chip supports only 3 voices and 1 noise channel, so you'll have to use the first 4 channels of an IT file, or use --channels to cherry-pick.

Noise notes are: C-0 (high buzz), C#0 (mid buzz), D-0 (low buzz), D#0 (borrow buzz), C-1 (high noise), C#1 (mid noise), D-1 (low noise), D#1 (borrow noise). "Borrowed" notes play frequencies borrowed from the third channel, though not very precisely. They're good for special effects like explosions or zaps, though, if you play a series of appropriate notes on channel 3 (probably with a volume of 0).

== Requirements ==

<blockquote>
* [https://www.perl.org/ Perl runtime]
* [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] or [https://openmpt.org/ OpenMPT]
</blockquote>

==Usage ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>

The script will produce a file called "<name>.ags".
</blockquote>

==Options ==

<blockquote>
* <code>--channels x,x,x,y</code> - select input channels. Default is <code>--channels 1,2,3,4</code> to output first four channels, with the last being used as noise. <code>--channels 1,2,3</code> would simply omit the noise channel. You'll probably have to use this to pick channels out of multi-channel input files, or rearrange them to put the noise channel last. Midi channels are numbered from 0.

* <code>--tempo-exact</code> - force exact tempo, at the cost of jittery playback. AGI engine plays using 1/60s ticks, so any playback must either use equal note lengths (at the cost of a different BPM from the original - by default), or try to match the original's BPM exactly by using varied note lengths. MIDI conversion uses exact tempo matching only.
* <code>--auto-drum-offs n</code> - automatically terminate notes on the noise channel after <code>n</code> ticks. Useful when converting input files that use short samples and don't bother terminating them, which would turn into long noise notes in AGI.
* <code>--instr-note x y</code> - force instrument <code>x</code> to play only note <code>y</code> . Useful to force a drum-like instrument to play only valid AGI drum notes. Typical notes are 13 (high noise), 14 (middle noise) and 15 (low noise). Combined with <code>--channels</code> to properly map an input channel to the noise output, and <code>--auto-drum-offs</code> to make output drums shorter, this option can turn a typical "rhythm channel" in the input into proper noise channel output for AGI.
* <code>--instr-shift x y</code> - shift (transpose) instrument <code>x</code> by <code>y</code> semitones. Use when input samples were recorded in a weird pitch, and notes in the input were written to match that. Or, use +12 or -12 to transpose by an octave.</blockquote>

== Version History ==

* ''0.2.1: Added recognizing MOD, S3M and XM modules, and MIDI files. They're not (yet?) supported, but recognized.''

* ''0.2.2: Experimental option --channels added''
* ''0.2.3: Tempo mode added: --tempo-exact''
* ''0.2.4: Auto drum note-offs added: --auto-drum-offs 1/2/3...''
* ''0.2.5: very basic MOD and MIDI support added''
* ''0.2.6: --auto-drum-offs now use AGI ticks for scale, not rows;'' ''--instr-drum'' ''added''
* ''0.2.7: --instr-drum changed to --instr-note, and'' ''--instr-oct to --instr-shift''
== Development Status ==

<blockquote>
Last updated: 2025-05-29.
</blockquote>

== Download ==

<blockquote>
Download from here:
* <div id="DL">[[Image:ZIP.png|ZIP File]] [[File:Impulse_Tracker_to_AGI_Sound_(ANY2AGI022).zip|IImpulse Tracker to_AGI Sound 0.2.3 (ANY2AGI022).zip]] <span class="DLInfo"> (ZIP file) [6.24 KB]</span><br /><br />'''GitHub:'''
<blockquote>
* [[github:SinusPi/any2agi|SinusPi/any2agi on GitHub]]
</blockquote>
</blockquote>

==<br /> Known issues ==

# IT2AGI doesn't (yet) support changing tempo or speed in the middle of the song. Don't try this, as it will be cruelly ignored.
# Finally, AGI is very limited in what it can do. If AGI doesn't support something, IT2AGI most likely doesn't either.

==<br /> Credits ==

* [[Adam Skawiński]]
* [[Nat Budin]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Sound Converters|AGI Sound Converters]]
* [[AGI Specifications: Chapter 9 - Sound Resources]]
 
[[Category:Sound Converters]]
[[Category:AGI Sound Converters]]

Sinus' Branch of Impulse Tracker to AGI Sound

2025-05-29T13:59:07Z

Sinus: first draft

<div align="center"><div style="font-size: 22pt">Sinus's Branch of Impulse Tracker to AGI Sound</div><br />
Version 0.2.3<br />''Author: [[Adam Skawiński]] and [[Nat Budin]]''<br />2025</div>

{{FanAGISoftwareInfobox
| Software = Impulse Tracker to AGI Sound (Sinus)
| Image =
| Version = 0.2.3
| ReleaseDate = {{2025}}-05-19<ref>https://sciprogramming.com/community/index.php?topic=9284.0</ref>
| Company = {{N/A}}
| Published = {{Published}}
| Developers = {{AdamSkawińskiToolDev}}, {{NatBudinToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{Perl}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[https://github.com/SinusPi/any2agi Yes]
| License = {{NoLicense}}
| Type = {{FanAGISoundConverter}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}, {{LinuxTool}}
| Localization = {{EnglishTool}}
| Website = https://github.com/SinusPi/any2agi
}}

<br />
==<br /> A.K.A. ==

* '''''ANY2AGI'''''

==<br /> Description ==

<blockquote>
[[User:Sinus|Adam 'Sinus' Skawiński]]'s branch of [[Nat Budin]]'s [[Impulse Tracker to AGI Sound]] Perl script adds support for noise channel and more input formats (now: IT, MOD and MIDI), as well as some quality-of-life options.

The [https://www.perl.org/ Perl language runtime] is required to run. Input music files may be created with [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker], [https://openmpt.org OpenMPT] or any MIDI editor.
</blockquote>

<div class="Quote">
{{Quote|Attrib = {{AdamSkawińskiQ}}<ref> https://sciprogramming.com/community/index.php?topic=9284.msg76242#msg76242 </ref>
}}
On the fourth channel, every even/odd octave defines noise/pattern, and every 4th note pitch defines frequency. C1=C3=C5=E1=E3=G#1=G#3. Play C1 C#1 D1 D#1 C2 C#2 D2 D#2 for a full range of sounds.
Just to clarify: there are no "drums" in IT, it's not MIDI, in trackers you define instruments as you see fit. But for this script, instruments don't matter. First three channels of the IT files are voices, the fourth channel is noises.
</div>

<blockquote>
{{TechToDo}}
</blockquote>

==<br /> Features ==

<blockquote>Input formats:
* Impulse Tracker (.it)
* Protracker (.mod) - basic support only, no tempo support yet
* MIDI (.mid) - input needs to have monophonic tracks or channels, no tempo support yet
Options:

* <code>--channels x,x,x,y</code> - select input channels. Default is <code>--channels 1,2,3,4</code> to output first four channels, with the last being used as noise. <code>--channels 1,2,3</code> would simply omit the noise channel. Midi channels are numbered from 0.
* <code>--tempo-exact</code> - force exact tempo, at the cost of even playback. AGI engine plays using 1/60s ticks, so any playback must either use equal note lengths (at the cost of a different BPM from the original - by default), or try to match the original's BPM exactly by using varied note lengths. MIDI conversion uses exact tempo matching only.
* <code>--auto-drum-offs n</code> - automatically terminate notes on the noise channel after <code>n</code> ticks. Useful when converting input files that use short samples and don't bother terminating them, which would turn into long noise notes in AGI.
* <code>--instr-note x y</code> - force instrument <code>x</code> to play only note <code>y</code> . Useful to force a drum-like instrument to play only valid AGI drum notes. Typical notes are 13 (high noise), 14 (middle noise) and 15 (low noise). Combined with <code>--channels</code> to properly map an input channel to the noise output, and <code>--auto-drum-offs</code> to make output drums shorter, this option can turn a typical "rhythm channel" in the input into proper noise channel output for AGI.
* <code>--instr-shift x y</code> - shift (transpose) instrument <code>x</code> by <code>y</code> semitones. Use when input samples were recorded in a weird pitch, and notes in the input were written to match that. Or, use +12 or -12 to transpose by an octave.</blockquote>

==<br /> Requirements ==

<blockquote>
* [https://www.perl.org/ Perl runtime]
* [https://www.lim.com.au/ImpulseTracker/ ImpulseTracker] or [https://openmpt.org/ OpenMPT]
</blockquote>

==<br /> Version History ==

<blockquote>
* ''0.2.1: Added recognizing MOD, S3M and XM modules, and MIDI files. They're not (yet?) supported, but recognized.''
* ''0.2.2: Experimental option --channels added''
* ''0.2.3: Tempo mode added: --tempo-exact''
* ''0.2.4: Auto drum note-offs added: --auto-drum-offs 1/2/3...''
* ''0.2.5: very basic MOD and MIDI support added''
* ''0.2.6: --auto-drum-offs now use AGI ticks for scale, not rows''
* ''--instr-drum 1 13 - remap IT/MOD instrument 1 to drum note 13 (13,14,15 are noises, 1,2,3 are buzzes)''
* ''0.2.7: --instr-drum changed to --instr-note, and'' ''# --instr-oct to --instr-shift''
</blockquote>

==<br /> Development Status ==

<blockquote>
{{AdamSkawinskiToolDev}} added support for 4-channel output ([[2025]]).
</blockquote>

==<br /> Options ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>.it

The script will produce a file called "<name>.ags".
</blockquote>

==<br /> Usage ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>.it

The script will produce a file called "<name>.ags".
</blockquote>

==<br /> Options ==

<blockquote>
To convert music, type this from the command line:

perl it2agi <name>.it

The script will produce a file called "<name>.ags".
</blockquote>

==<br /> Download ==

<blockquote>
Download from here:
* <div id="DL">[[Image:ZIP.png|ZIP File]] [[File:Impulse_Tracker_to_AGI_Sound_(ANY2AGI022).zip|IImpulse Tracker to_AGI Sound 0.2.3 (ANY2AGI022).zip]] <span class="DLInfo"> (ZIP file) [6.24 KB]</span><br /><br />'''GitHub:'''
<blockquote>
* https://github.com/SinusPi/any2agi SinusPi/any2agi on GitHub]
</blockquote>
</blockquote>

==<br /> Known issues ==

# IT2AGI doesn't (yet) support changing tempo or speed in the middle of the song. Don't try this, as it will be cruelly ignored.
# Volumes aren't supported either, yet. They will be in the next version. For now, everything is played full blast.
# Finally, AGI is very limited in what it can do. If AGI doesn't support something, IT2AGI most likely doesn't either.

==<br /> Credits ==

* [[Adam Skawiński]]
* [[Nat Budin]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Sound Converters|AGI Sound Converters]]
* [[AGI Specifications: Chapter 9 - Sound Resources]]
 
[[Category:Sound Converters]]
[[Category:AGI Sound Converters]]