![[All projects]](images/buttons/All%20projects.gif) ![[View on GitHub]](images/buttons/View%20on%20GitHub.gif) ![[Git Log]](images/buttons/Git%20Log.gif) | Name: | Filer | | Short description: | Filer - AmigaOS 4 file lister (OpenAmiga project) | | Visibility: | Private | | Last updated: | 2026-11-20 13:52 | | Languages: | C 98.6%, Makefile 0.5%, Shell 0.4%, Python 0.3%, Assembly 0.1% | | License: | None |
Filer
A file manager for the AmigaOS 4 Workbench: listers that show a drawer as
a list or as icons, with a toolbar for copying, moving, deleting and
renaming, user defined buttons, file types, thumbnails, archive browsing
and an OS4Depot mode. Filer is an OpenAmiga.org project.
Each lister is a process of its own. FilerCX is a commodity that opens a
lister with a hot key, FilerPrefs sets everything up, and Thumber makes
the thumbnails of pictures.
Built on ReAction classes, the FileBrowser gadget (a listbrowser.gadget
subclass with an icon view, OpenAmiga-org/FileBrowser),
xadmaster.library for archives and the arcedit command for changing
them.
Download: Filer on OS4Depot
(Filer, FilerCX, FilerPrefs, Thumber, images, Install script);
Swedish catalogs
in an archive of their own.
Layout
src/ Filer itself (one source file per area:
Gui.c, DosIO.c, Archive.c, OS4Depot.c...),
its catalog description Filer.cd and the
Swedish translation in Catalogs/
src/launcher/ FilerCX, the commodity
src/prefs/ FilerPrefs
src/thumber/ Thumber, the thumbnail maker
src/images/ toolbar and list images (the .png files are
their sources)
src/FileBrowser.c the FileBrowser gadget, same source as
OpenAmiga-org/FileBrowser
package/ Filer.readme and Filer_swe.readme (OS4Depot
readmes), Readme.txt
(the manual in the archive), the Install
scripts (Install_swe for the Swedish
catalogs) and icons
documentation/ changelog.md (every change in detail),
spec.md (behaviour specification), plans
tools/ make_lha.sh (release archives),
update_readme.py (the changelog below, from
the readme), set_tooltypes.py (the Swedish
Install icon)
build_os4.sh cross build of all four programs
contributors.txt the people who worked on Filer
Using it
Unpack the archive and start Install in the Filer drawer. It installs
the Filer drawer (SYS:Utilities by default), FilerCX in
SYS:Utilities/Commodities and, on request, starts FilerCX with the
computer. package/Readme.txt is the manual: user buttons, file types,
the toolbar, archives, OS4Depot mode and troubleshooting.
Needs AmigaOS 4.1; xadmaster.library to browse archives, the arcedit
command (OS4Depot utility/archive/arcedit.lha) to change them, and wget
for OS4Depot mode.
Building
./build_os4.sh # all four programs -> ~/build/filer-os4
./build_os4.sh prefs # one of filer, launcher, thumber, prefs
tools/make_lha.sh # release archives -> dist/filer.lha, filer_swe.lha
build_os4.sh cross-builds in the walkero AmigaOS 4 GCC docker image
(walkero/amigagccondocker:os4-gcc15-3.6.1, GCC 15 with newlib) and
reads the object lists and CFLAGS from each program's Makefile, so a
native build on the Amiga uses the same settings. make_lha.sh checks
the version strings, strips the programs (the .debug files keep the
symbols), sets the Amiga protection bits with arcedit and updates the
changelog here. Catalogs are built with FlexCat.
Design notes
- One process per lister. Listers talk to each other through message
ports (drag & drop, the destination picker, Clone Lister).
- A drawer shown in a lister is watched with DOS notification and read
again when it changes; the root view follows the DOS list.
- Archive mode reads archives with xadmaster and changes them by running
arcedit, so Filer itself never writes an archive format.
- OS4Depot mode runs every download as a wget process of its own, into a
name of its own, so several listers can use it at the same time.
documentation/spec.md describes the expected behaviour; a black-box
test suite outside this repository checks Filer against it on an
AmigaOS 4 guest.
Changelog
<!-- changelog start: made by tools/update_readme.py from package/Filer.readme -->
- 53.50 (2026-11-15):
- Built with the current AmigaOS 4 SDK and GCC 15. Install script for the Installation Utility, also over a running Filer; new Install icon.
- Icon view per lister (Lister > Show), with full-size icons, thumbnails or DefIcons, a selection box and icons without a file shown as entries.
- Lister > Sort by menu: name, size, date, comment, reverse order.
- Archives (xadmaster): double-click opens an archive like a drawer, Copy to unpacks from it, and the new Unpack button unpacks whole archives.
- Progress windows show the whole operation (entries) above the current file's bar; archives use them too, with Cancel.
- Changing archives with the arcedit command: delete, rename, comment, protect, add and move files.
- The root view follows the DOS list: volumes and assigns that come and go show up at once.
- Copy to, Move to and user buttons offer the other listers' drawers as the destination.
- OS4Depot mode: https, Host and Work folder settings, an OS4Depot menu, downloads that can be cancelled, failures reported, several listers at once.
- Soft and hard links are copied and moved as links.
- Clone Lister keeps the lister's view and sort settings (new arguments VIEW, ONLYICONS, INFOFILES, SORT, DESCENDING).
- Icons and thumbnails are not read from FTP:, SFTP: and WDV: by default.
- Much faster listings and copies into drawers shown in a lister.
- Many fixes: memory corruption in every copy, crashes on quit and when the prefs change, memory leaks, FilerCX from WBStartup, Snapshot saving all settings, Cancel after Test in FilerPrefs.
- Swedish catalogs updated, in their own archive filer_swe.lha again. Full list of changes: https://github.com/OpenAmiga-org/Filer/blob/main/documentation/changelog.md
<!-- changelog end -->
History
Filer was started in 2008 by Vicente Gimeno for OpenAmiga.org, and was
then mostly written by Björn Hagström, with code by Alexandre Balaban,
Fredrik Wikström, 'TSK' and others and gadget images by Martin Merz. It
lived in the OpenAmiga.org Subversion repository from 2008 to 2023 (most
work 2008 to 2010, then 2022 and 2023); the last release on OS4Depot was
53.32 in 2013, and 53.35 (2023) was the last version built there.
Moved to GitHub in November 2026, starting from the 53.35 source; the
Subversion history is kept on the svn-history branch. 53.50 is the
first version built from this repository. |