otomatalabs/furnace
8
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

some changes

Browse source 
- the quick start guide is important, but boasting up-to-dateness may (or may not) be incorrect.
- changed terminology from "folder" to "directory" where applicable.
- components.md: it is not Furnace's job to teach the user about familiar GUI widgets.
This commit is contained in:
tildearrow 2026-01-15 13:06:32 -05:00
parent 45b10e4962
commit a09d470681
4 changed files with 8 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

2
doc/1-intro/README.md
View file

@ -26,7 +26,7 @@ once familiar with the tracker, look to [9-guides](../9-guides/README.md) for us
## tutorial?
- the [quick start guide](quickstart.md): text and images tutorial. offers a learn-by-doing approach. always up to date.
- the [quick start guide](quickstart.md).
- [How to Learn Chiptune Trackers](https://www.youtube.com/watch?v=Q37XuOLz0jw): video tutorial created by Button Masher. covers the basic mechanics of chiptune tracking using Furnace for demonstration.
- [Furnace Tutorials](https://youtube.com/playlist?list=PLCELB6AsTZUnwv0PC5AAGHjvg47F44YQ1): video tutorials created by Spinning Square Waves. be noted that these may not apply to the current version.

4
doc/1-intro/quickstart.md
View file

@ -3,7 +3,7 @@
Furnace is amazingly versatile, but it can also be intimidating, even for those already familiar with trackers. this quick start guide will get you on the road to making the chiptunes of your dreams! if you're a beginner, it will probably take about an hour from start to finish.
this guide makes a few assumptions:
* you've already installed Furnace and know where to find the `demos` folder that comes with it. look for `quickstart.fur` but don't open it yet.
* you've already installed Furnace and know where to find the `demos` directory that comes with it. look for `quickstart.fur` but don't open it yet.
* you haven't changed any configuration or layout yet. it should start up with the default Sega Genesis system.
* you're working with a PC keyboard, US English, QWERTY layout. Mac users should already know the equivalents to the `Ctrl` and `Alt` keys.
* you're comfortable with keyboard shortcuts. if not, a lot of this can also be done using buttons or menus, but please try the keyboard first. it's worth it to smooth out the tracking workflow.
@ -221,6 +221,6 @@ now you know the basics of how to make music with Furnace. from here, the rest o
a great way to learn how to make your own music is to study how others have done it. try the demo modules! not only do they sound good and show off Furnace's capabilities, but they're also great for learning tracking techniques. one recommended method is this: open a demo track you like, open a second copy, save it to a new file, use the menu option "edit > clear..." and click "clear all subsongs", and remake the track by transcribing from the original.
remember that everything in the `instruments` folder is free for you to use in your own music, as well as instruments found in the demo songs.
remember that everything in the `instruments` directory is free for you to use in your own music, as well as instruments found in the demo songs.
most of all, don't be afraid to experiment. go play!

8
doc/2-interface/components.md
View file

@ -34,13 +34,13 @@ once you click away it will become a slider again.
## color selectors
this will appear as a small colored square (swatch) anywhere a color may be selected. they may also have numeric entry to the left.
this will appear as a colored square (swatch) anywhere a color may be selected. they may also have numeric entry to the left.
left-click the swatch to pop up a large color panel.
- click directly within the large square to select saturation and value, and to the rainbow bar on its right to select hue.
left-click the swatch to open the color panel.
- click directly within the panel area to select saturation and value, and to the rainbow bar on the right to select hue.
- further to the right there may be "Current" and "Original" swatches. click the "Original" swatch to revert to that color.
- below that are numeric entry boxes for RGBA (red, green, blue, alpha/opacity) and HSVA (hue, saturation, value, alpha/opacity) formats. click and drag on a number to raise or lower it. double-click to edit it as text. right-click to choose whether numbers are entered as integers between 0 and 255 or decimals between 0.0 and 1.0.
- below that is a directly editable web-style hexadecimal RGBA color value in a standard text box.
- below that is a directly editable web-style hexadecimal RGBA color value in a text input field.
right-click the swatch or its numeric entry boxes to select the color format and numbers in use.

2
doc/7-systems/pcspkr.md
View file

@ -38,7 +38,7 @@ this chip uses the [Beeper](../4-instrument/beeper.md) instrument editor.
two ROM export options exist:
- **iPod .tone alarm**: with the iPod _in disk mode,_ drag the export file into the `iPod_Control/Tones` folder.
- **iPod .tone alarm**: with the iPod _in disk mode,_ drag the export file into the `iPod_Control/Tones` directory.
- **GRUB_INIT_TUNE**: use with the GRUB bootloader.
- into the file `/etc/default/grub` add the following line with the text output copied and pasted where `text` is:\
`GRUB_INIT_TUNE="text"`\