* Changes between versions				-*- outline -*-

This file (NEWS) documents the significant changes between all
versions of aylet and taylet, with the newest changes first.


* Changes in taylet 0.7.2

No change in the programs since 0.7. The sources of 0.7.1 still said
0.7 as their version number (taylet --version, the man pages and the
AppStream file); it is now right.

The licence of every file is now stated in the file itself, with SPDX
headers, or in REUSE.toml; the texts of the licences are in LICENSES/,
and the project follows the REUSE specification. The old files keep
the copyright lines of their authors, and the contributors of the OSS
and OpenBSD drivers are named.


* Changes in taylet 0.7

taylet-kde has a settings dialog (Settings menu, Configure Taylet...).
The settings are described in a KConfigXT file (src/kde/taylet.kcfg)
and kept in ~/.config/tayletrc. They are the ones which taylet takes
on its command line: mono or stereo, ABC stereo positions, narrow
stereo separation, pseudo-stereo for the beeper, the time after which
a track fades out and the duration of the fade-out. There are also a
setting to play the next track when one ends, and one to restore the
play list (see below). The audio settings apply the next time a
playback starts, the others from the next track.

taylet-kde keeps its play list from one run to the next. The files and
the tracks are saved when the window is closed, in
~/.local/state/tayletstaterc, and come back when taylet-kde is started
without any file; nothing is played, and the line which was selected is
selected again. The files which are gone are left out. This can be
turned off with the settings.

Only one taylet-kde runs at a time in a session (it uses KDBusService).
Starting it again, from a menu or a file manager, brings the window of
the running one to the front; if files are given, they replace its play
list and are played, as on a first start.

taylet-kde can be controlled through MPRIS2, the D-Bus interface of media
players (org.mpris.MediaPlayer2.taylet): the media keys, the media
controls of the desktop and playerctl can play, pause, stop, change
track and read the title, the author and the comment of the current
track. Seeking is not possible, and there is no volume control.

taylet-kde installs a menu entry (org.eu.fr.emor3j.taylet.desktop) and a
MIME type, audio/x-ay (a file which begins with "ZXAYEMUL", or whose
name ends in .ay), so that the desktop can offer it to open .ay files.
It also has an icon (org.eu.fr.emor3j.taylet.svg, a scalable icon
installed in the hicolor theme).

taylet-kde is translated into French, German, Spanish, Italian, Russian,
Simplified Chinese and Japanese, with ki18n (po/). The translations were
written by an AI assistant and have not been reviewed by native speakers.
Building taylet-kde needs gettext (msgfmt) for this.

taylet-kde has AppStream data (org.eu.fr.emor3j.taylet.metainfo.xml,
installed in share/metainfo), so that software centers can describe it.
Its texts, and those of the menu entry, are translated in the same
languages.

Building taylet-kde now also
needs KDE Frameworks 6 Config, DBusAddons and WindowSystem
(libkf6config-dev, libkf6dbusaddons-dev and libkf6windowsystem-dev on
Debian).


* Changes in taylet 0.6

This is the first release of taylet, a fork of aylet 0.5 (the last
release of aylet, in 2005). The program is now called taylet.

The curses interface (`aylet') and the GTK+ interface (`xaylet') have
been removed, and with them the dependencies on ncurses and GTK+.
taylet is a plain command-line player: it plays the files given on
the command line, one track after the other, and exits after the last
one (with an exit status of 0). There are no interactive controls any
more. Press Ctrl-C (or send SIGTERM) to stop earlier; the sound
output is then closed properly. The long options `--help' and
`--version' have been added.

The build system is now CMake (3.18 or later), and a C11 compiler is
needed. Each program is chosen with an option and nothing is enabled
or disabled depending on what happens to be installed; see the README.
Three programs can be built:

  taylet      has no dependency. By default it has no audio driver
              and writes the samples to standard output (`-s'), to be
              sent to a player such as aplay. It can also be built
              with the OSS or the OpenBSD audio driver.
  taylet-sdl  plays the sound through SDL2, so it works with
              PipeWire, PulseAudio or ALSA without any other
              program. It takes the same options as taylet, except
              `-s'.
  taylet-kde  a graphical player using Qt 6 and the KDE Frameworks 6,
              still under development: it opens files, keeps a play
              list of their tracks and plays them in sequence.

The OSS and OpenBSD audio drivers come from aylet and have not been
tested since the changes made in taylet.

The emulation (Z80, AY and beeper sound, .ay files, player) is now a
separate core, which knows nothing about the user interfaces; the
audio output drivers talk to it through a small interface of their
own. There are man pages for taylet, taylet-sdl and taylet-kde.

The source code is on https://salsa.debian.org/emor3j/taylet


* Changes in aylet 0.5

Fixed a stupid bug where the fadeout time defaulted to zero, so by
default all tracks lasting longer than 3 minutes were cut off
abruptly.


* Changes in aylet 0.4

Added 16-bit support. Now defaults to this when possible. New option
`-e' forces 8-bit playback (even that is improved, due to the 16-bit
mixing now done). Thanks to Stuart Brady for inspiring this change.

Added `-t' option, to play only a given track (actually slightly
different, see the man page). Thanks to Bartlomiej Ochman for this.

Fixed unhelpful interactive stop-after-setting behaviour when started
with stop-after set to something not a multiple of 30 seconds; now the
first interactive change will set it to the nearest multiple in the
specified direction. Thanks to Bartlomiej Ochman for this too.

Fixed a compilation error with newer versions of gcc (the code was
wrong before, but wasn't complained about). Thanks to Daniel Baumann
for pointing this one out.


* Changes in aylet 0.3

Finally uses accurate AY levels. Thanks to Matthew Westcott for the
measurements these were based on.

Removed beeper fading, which wasn't actually necessary and was causing
problems with some tracks, most noticeably in Trantor. The rest
position is still central for AY-only and CPC tracks, though, so the
change shouldn't affect those.

Added partial port-bitmask to allow for certain less-than-ideal .ay
conversions. Thanks to Vít Hotárek for helping find this one.

Fixed silly typo which meant that L and L' weren't set correctly when
starting up the Z80. (Though curiously, this bug didn't seem to break
any .ay files.) Thanks to Patrik Rak for spotting this.

Previously, when a track stopped and happened to do so leaving
high/low level `silence' (e.g. a few AY tracks and, given the
beeper-fade removal, all beeper tracks), if this change happened
during a fade the fading level would screw up the silence detection
and give (with default settings) up to ten seconds of extra `silence'.
Now fixed.

In xaylet, long file details (e.g. track name) no longer expand the
window to fit, but are clipped. You can still manually resize the
window to see the rest of the text, if you like.


* Changes in aylet 0.2

OUT instructions previously took too long, making some beeper tunes
(e.g. Heavy on the Magick) sound terribly slow - fixed.

New AY volume levels, which should more closely reflect actual AY
output.

Added support for CPC files.

A native sound driver for OpenBSD. Thanks to Chris Cox for this.

Fixed most clicking problems. There are still a few, but it's doing
much better than before.

Rewrote envelope emulation, the old one couldn't be made to cope with
high-speed envelopes (as used in some demos). Also fixes
presumably-accidental zero-period envelope use with `negative' volume
(e.g. Afterburner).

Fixed high-frequency noise.

Beeper tones inverted, so they're now the right way up. :-)

Changed field label from "Title" to "Misc" throughout. Some files use
it for Title, some Copyright, some both. So "Misc" is about the only
reasonable label.


* Changes in aylet 0.1

Everything. :-)
