psfs2cpi(1)

📦
version 1.1.3 · 2 versions
, in nixpkgs unstable, ubuntu stonking

✨ psfs2cpi — the PSF → CPI glow-up ✨

okay bestie, gather round, because this little tool is literally the moment one or more PSF files get combined into a single CPI file. it's giving codepage assembly line. 💅

🌸 SYNOPSIS 🌸

psfs2cpi [--device=DEV] [--comment=TEXT] [--drfont] [--nt] [ +CODEPAGE |
+CODEPAGE=CPNAME ] INPUTFILE [INPUTFILE ...]  [+CODEPAGE INPUTFILE
[INPUTFILE ...]]  OUTPUTFILE

🦋 DESCRIPTION 🦋

so psfs2cpi combines one or more PSF files into a CPI file. that's the whole vibe. ✨

when you run it, you hand it a list of codepage numbers. each number then has to be followed by the names of one or more PSF files, and those are where the character shapes come from. like, the character shapes are the main characters here 👑

for example, this command right here:

psfs2cpi +437 eg8.psf eg16.psf +850 eg8.psf eg16.psf +860 eg8.psf
eg16.psf +863 eh8.psf eh16.psf eg.cpi

will generate a CPI file called eg.cpi, containing codepages 437, 850, 860 and 863 in two sizes. the first three codepages will have been based on eg8.psf and eg16.psf; the last one on eh8.psf and eh16.psf. iconic behaviour, no notes. 🎀

a codepage number can be followed by a directive saying which mapping table will actually be used. for example, if the start of the above command had read:

psfs2cpi +437=PPC437 ...

then codepage 437 would have been generated using the slightly different PPC437 mapping. tiny change, big difference, iykyk. 🙈

and here's the tea: if the PSF files in question have Unicode directories, and the codepage is one of the ones known to psfs2cpi, then the appropriate glyphs will be extracted from the file — that's literally how three codepages can be based on a single PSF file. slay. but if the codepage number is not known, or the PSF file has no Unicode directory, then the first 256 characters of the PSF file will be used instead. fallback queen. 💖

💜 OPTIONS 💜

  • --device=devname — sets the device name to store in the codepage file. this defaults to "EGA", so if you don't say anything, EGA it is. but if you're generating a codepage file for the IBM Convertible, you should set it to "LCD" instead. know your audience, basically. 💅
  • --comment=comment — sets a comment which will be added to the end of the CPI file, like a copyright message. little signature at the bottom, very cute. 🎀
  • --drfont — outputs in the compressed format used by DRDOS. zip it, squeeze it, serve it. 🔥
  • --nt — outputs in the FONT.NT format used by Windows NT. windows said lemme get a format too 😭

🌈 SEE ALSO 🌈

(the whole friend group fr fr 🫶)

👑 AUTHOR 👑

John Elliott <seasip.webmaster@gmail.com>. thank you john, king behaviour ⭐

that's the whole page bestie!! 🍓 this was Version 1.1.3, dated 28 April, 2026, coming to you straight from PSF Tools 🧚✨ go forth and build your codepages, you absolute icon 💖

📦 where this page comes from