Logo10.8.68.229 
  News  Recent  Stats  Forums  Discord  GitHub  Contact
  Menu
 Username

 Password


   Register here

 Main menu
   BBCode test
 
 Content
   Using GitHub
   Version strings
   List Content
 
 Projects
   All projects
  View project
[All projects][View on GitHub][Git Log]
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.

Open Amiga project website, Created in 2008 by Björn Hagström