This code is beta release code, provided "as-is" with no warranty implied, it WILL crash (even when used correctly), it has memory leaks and incomplete features and functions, use it at your own risk, do not run it with admin rights or superuser/root (it's not needed).

Decided to bundle the MacOS and Linux code in the same single zip file (why not?).

At the moment the MacOS and Linux code is (are?) statically linked, so no messing with libraries, but if/when there's GUI's or need to expose the functions as .dynlib/.so I'll create them as dynamic libraries (like the Windows DLL).

Started to keep old versions in case of bugs introduced - if you find an issue then use the CLI and issue "loglevel 9" before you run the commands that cause the error, "loglevel 1" to only display essential info (default) loglevel 0 to switch logging off and "logfile logfile-name" to send output into a file.

29/12/2022 Final 2022 release; Capitoline.v0.42(Xmas.2022).zip

  • skick/RTB generator rehashed, tested with v2.05/3.1.4/3.2 ROMs

You can generate RTB files for use with skick (and others apps such as WHDLoad/mkick), this allows you to soft load different kickstarts, including your own custom ones, kicking a KS 1.x is more problematic as they use BCPL relocs which I don't cater for - maybe next time!

  • GUI bugs displaying the wrong files or colours fixed

It wasn't scanning and reading the right tags after I renamed them for consistency.

  • Kickstart 1.x and 2.x definition files 

You'll be able to pull apart/rebuild KS 2.x, but KS 1.x is more tricky (unless you keep dos.library in the same address), added a 1.4 and some 3.0, also updated the exec libraries for skick entries (scantable).

  • CDTV Extended ROM definitions added, including the unofficial CDTV land 2.35 extended ROMs

I've only done 2.7/2.30 ROMs and the 2.35 from CDTV Land - these contain quite a few patches, so if you have a CDTV, pop over to their site and give them a look.

  • Few random bugs fixed, more than I can remember to be honest, but no big ones

I've discovered a couple of issues that I've added to the bug log, there's a odd crash when auditing a very large number of files, this might result in files not appearing in the GUI, but I've yet to get a consistent, repeatable test. Some of the GUI colours show up green for ROMs that don't have definitions for, this is when a file contains an unknown ROM, e.g. an encrypted ROM, I'll fix this next time.


10/1/2022 Time for a roll-up update; CapitolineV0.40(2022.rollup).zip

  • Loading RAW data crashes Fixed - Only initialised a buffer properly if the data has a HEADER chunk.
  • Windows GUI had bad line breaks in the CLI (script) interface, caused various cut/paste issues
  • Windows GUI now Resizable (more work than it sounds)
  • More accurate/faster scanning of files
  • Cloanto encrypted/KickIt/ReKick files presented better, loading better, no crashes if keys missing
  • Windows DLL functions documented
  • echo command, useful for finding values of aliases/variables
  • #comments ignored (a hash/pound ignores the line)
  • Fixed falure analysing overburnt ROMs (detects overburning and only loads one copy now)
  • Added 3.2 and 3.2.1 ROM definitions and updates (and completed a couple of 3.2.1)
  • You can now load files based on their CRC32 hash rather than their location

18/6/2021 Added basic ADF support, tidy up GUI information handling; CapitolineV0.30(Beta3.ADF).zip

  • Virtual ADF in the GUI, right-click to "Load ADF", then right click the individual files to add to the current Kickstart or extract to file
  • In capcli you can "loadadf /path/to/adffile.adf" then "add ADF:/path/in/adf/to/filename.library"
  • I seem to have forgotten to add the ability to extract files directly from the ADF in capcli (Windows GUI only) - I'll do that next time
  • The Windows GUI is much tidier now, with fewer "unknown file" warnings, better icon handling

The ADF functionality is very, very limited as I'm not sure what I'm going to do with it yet, ADFs are read-only, only 880k OFS/FFS supported, but I'll add more ADF features as I need them - or if people request them.


8/6/2021 Minor updates, 3.2 Definitions; CapitolineV0.21(Beta2)-fixed-2.zip

11/6/2021 - update, 32bit version accidentally included which broke the Windows GUI (replaced with 64bit version now).

14/6/2021 - update, Missed the kickstart definitions for 3.2 (all modules were there, but not the main Kickstart definition).

  • New 3.2 definitions added (and some other 3.1.4 plus a couple of other random/rare ones)
  • New Windows binary (compiled with Visual Studio, hopefully to stop false positive virus warnings)
  • HI/LO ROM name reverse bug (found by Simon Wilkie)
  • Logfile bug fixed (found by Ian Court)
  • Loglevel command added to reduced noise
  • Various missassembler fixes (better extension word handling - but not complete) - usable but not as good as a commercial disassembler
  • capcli commands slightly renamed for clarity/architecture
  • New way of bundling code
  • "test bed" of repeatable tests being built - not included in zip yet, but will speed up testing
  • Website documents updated


13/10/2020 Roll-up of fixes; CapitolineV0.2(Beta2).zip

  • New MacOS compile (Catalina), if you need an older version then I can add High Sierra 
  • Extended number of source files to 9999 and hash files to 9999, should make this automatic, but I'm too lazy
  • Missassember fixes (it ignored some mnemonic differences) 
  • Added more inbuilt aliases, better checksum, ranges etc. I should probably document these
  • New patching functions, copying chunks etc.
  • Fixed a patching issue which always component 0
  • Lots of new hash files for some remaining v3 kickstarts and most v2 kickstarts, might do some v1 if I can be arsed

Moved the code to a beta designation since finding and removing some initialization bugs


16/4/2020 Significant update, various bugs fixed;

  • A serious one (not being able to save a ROM!)
  • A serious one (patching only did half the job, and mostly to he wrong location)
  • Not clearing deleted components (logical, not physical deletion)
  • GUI now checksums automatically if you save a ROM
  • Ability to checksum was accidentally removed!

Enhancements to the patching language, means you can directly access the current checksum ($CHECKSUM) and you can search for opcodes (it even calculates relative displacement) e.g. findopcode $exec.library "LEA F80352(PC),A0", you can also substring aliases (variables).

9/4/2020 Linux command line compiled and posted, same as MacOS version, changes need backporting to Windows
9/4/2020 MacOS command line compiled and posted, slightly newer version, changes need backporting
3/4/2020 Significant update to the disassembler, decodes Brief Extension Words, plus a load more 68000 mnemonics
26/3/202 Bugfix copying directly from an existing ROM to a working image (mishandled ROMBASE)
4/3/2020 First public release

To install;

  • Unzip the archive anywhere

It's best to copy your ROMs and any modules into a folder under Capitoline before you run

To run;

  • Run "capitoline.exe"
  • Select the "Capitoline" folder that contains "Capitoline Hashes"

It will scan the files and folders under this directory structure each time you start Capitoline, so if you add any new ROMs etc. you will need to exit and re-run (there's no refresh function).





I BUILT MY SITE FOR FREE USING