Software for 6502: Difference between revisions

From F256 Foenix
Jump to navigationJump to search
mNo edit summary
 
(97 intermediate revisions by 14 users not shown)
Line 1: Line 1:
Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it.
Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it. For extra help on how to run .bin files and almost every possible scheme that has to be used to run program, you can consult this video that's also part of [[Getting Started]], this one: https://www.youtube.com/watch?v=0ShFv89KGDs


Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.
Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.


A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.
A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.  


There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.   
There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.   
===== Curated SD card collection of games, demos, utilities =====
Here is a download link to a zip file meant to be extracted into the root of an SD card: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
Best to wipe out your SD card and start anew with the contents of this extracted to root. Micah's file manager doesn't like long lists of files so it really is best to not overdo it. I tried to minimize the files in root, but I couldn't for everything.
Open the readme.txt file with moreorless to see some instructions about the collection. Best to run /- fm first, then open the readme.txt from it


== Applications ==
== Applications ==
Line 21: Line 28:
|basic
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit
|https://github.com/econtrerasd/F256-GraphicToolkit
|-
|F256 f/term
|Terminal emulator for F256K and Jr with classic (flat) memory load
|Micah
| - fterm.pgZ or use f/manager
|https://github.com/WartyMN/F256-terminal/blob/main/release/fterm.pgZ
|-
|FoenixTarot
|Tarot card readings in SuperBasic
|Mike
|basic
|https://github.com/mcassera/FoenixTarot/tree/main
|-
|Forthf256
|Forth implementation
|Vasyl
|pgz in its forth/ folder
|https://github.com/VasylTsv/ForthX16
|}
|}


Line 31: Line 56:
!Notes on running
!Notes on running
!Link
!Link
|-
|badapple
|A 80x60 textmode port of Bad Apple, uses the VS1053b for quality mp3 audio. Needs a Jr2 or K2!
|Mu0n
|pgz*
|*unzip badapple.zip into the root of your SD card. If done right, the 3 files within will be in the demos/ folder. The program expects its data file there when it runs. https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/badapple.zip
|-
|-
|balls
|balls
Line 37: Line 68:
|pgz
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256Archon
|Splash screen intro, plays MIDI using the SAM2695, requires a K2 or Jr2
|Mu0n
|pgz
|https://github.com/Mu0n/F256Archon/releases
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|-
|F256 Mandelbrot
|F256 Mandelbrot
Line 54: Line 97:
|dwsJason and digarok
|dwsJason and digarok
|pgz
|pgz
|https://discordapp.com/channels/691915291721990194/934618943400837130/1188633998663098398 if you have Dec23 FPGA load or newer
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/xmas24_k2.pgz revised version that can run on wave 2 Jr2 and K2 as well
https://discordapp.com/channels/691915291721990194/934618943400837130/1188633118194794527 if you have an older FPGA load
|-
|-
|foenixmas23
|foenixmas23
Line 91: Line 133:
!Notes on running
!Notes on running
!Link
!Link
|-
|bbombers
|Boulder Bombers (Alpha-2)  Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers<nowiki/>https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|-
|Bombsweeper
|Bombsweeper
Line 103: Line 152:
|pgz
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|-
|F256 two to the power of eleven
|F256 two to the power of eleven
Line 109: Line 164:
|pgz
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|FusionDrive
|An outrun type game that also plays a MIDI soundtrack
|Mu0n
|pgz
|wip v0.2, can use a NES pad #1 to move around, or left/right arrow keys currently https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|-
|Jr Wördl
|Jr Wördl
Line 115: Line 184:
|basic
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://discord.com/channels/691915291721990194/1230670413361844244/1317256215566487593 1.0 Beta 19 Demo]
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|-
|Shanghai/Mahjongg
|A clone of Shanghai. Also known as Mahjongg
|mgr42
|pgz or KUP
mouse needed
|https://github.com/rmsk2/f256_mahjong
|-
|-
|Ski-Jr
|Ski-Jr
Line 122: Line 232:
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|-
|Lair of the Lich King
|Track & Field
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Olympic Game by Konami (WIP)
|Micah
|Scott (xDraconian)
| - lkdemo/lk.pgz
|pgz
|[https://cdn.discordapp.com/attachments/855689509520932885/1206778663526469632/lk_f256_1.0b19_demo.zip?ex=65dd3f36&is=65caca36&hm=30911e1c516874ce80a4e56bfa847ea933da1f37918eb44ced33dddc9e91197e& 1.0 Beta 19 Demo]
atari joystick or keyboard
|
|-
|Tetris
|Good old 80's game
|Daniel Tremblay (Grenouye)
|pgz
atari joystick or keyboard
|https://github.com/dtremblay/c256-tetris/tree/f256k
|}
 
== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|}
 
== Game Jam #02 - October 25th-November 1st 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bach's MIDI Hero
|Free MIDI/PSG play + note play tutorial
|Mu0n
|pgz
the MIDI feature requires a F256K2 or F256Jr2; a legacy PSG option also allows F256K and F256Jr to still hear it. Optionally uses a MIDI in controller plugged in.
|https://github.com/Mu0n/F256KsimpleCdoodles/releases/download/v1.2/BachHero.pgz
|-
|f256_snake
|
|mgr42
|pgz. Use cursor keys, Atari joystick or SNES pad to play
|https://github.com/rmsk2/f256_snake
|-
|fnxsnake
|
|silk-neon
|pgz
|https://github.com/ksiondag/fnxsnake
|-
|The Hallow
|
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamOct2024
|-
|Halloween Birthday
|
|SprySloth
|pgz
|https://github.com/cmassat/GameJam2024_F256K
|-
|Haunted Mansion
|
|digarok
|superbasic
|https://github.com/digarok/fnxgamejam-haunted-mansion
|-
|Kooyan
|
|Grenouye
|pgz
|https://github.com/dtremblay/kooyan.git
|-
|Spooky Run
|
|dwsJason
|pgz
|https://github.com/dwsJason/spooky
|-
|Trick or Treat
|
|Mike
|pgz
|https://github.com/mcassera/TrickOrTreat
|-
|Ultima III - Exodus
|port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Ultima_3
|-
|Warlock
|remake of 68000 game
|xDraconian
|pgz
atari joystick
DOWN=change_level
UP=jump
UP-LEFT=leap
UP-RIGHT=leap
|https://github.com/scttgs0/Foenix_GameJam_Oct2024
|}
 
 
== Game Jam #03 - April 18th-April 27th 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Arcade Shanghai v1.2
|Shanghai clone
|contrerasd
|basic, keep the .bas program in root, the rest in the provided ashanghai/ folder
|https://github.com/econtrerasd/ashanghai/releases
|-
|Bawk Bawk Cluck Cluck
|Chicken themed platformer
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamApr2025
|-
|BitLadder
|Shoot 'Em Up
|Mu0n
|pgz. For full sound compatibility, a Jr2 or K2 is needed.
Uses 4 sound chips! (PSG, SID, OPL3, MIDI)
|https://mu0n.itch.io/bitladder
|-
|F256_Commando
|Commando port
|SprySloth
|pgz
|https://github.com/cmassat/F256_Commando
|-
|F256_LodeRunner
|Lode Runner port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Loderunner/releases
|-
|Mahjong
|Shangai clone
|mgr42
|pgz
|https://github.com/rmsk2/f256_mahjong/releases
|-
|Quarth
|Block placement arcade game
|Grenouye
|pgz
|https://grenouye.itch.io/f256-quarth
|-
|Skee(ster)-Ball
|
|Mike
|pgz
|https://github.com/mcassera/skeeball256/tree/main
|}
|}


Line 138: Line 453:
!Notes on running
!Notes on running
!Link
!Link
|-
|audioplayer
(aka 'F256amp')
|mp3, ogg, wav, wma file playback
|Mu0n
|pgz
|v2.1 Needs a Jr.2 or K2 since it uses the VS1053b chip. https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
run operation 1: just as itself, it will force you to pick an audio file. it expects a <code>mp3/</code> folder, but it can live without it and peek into the root instead.
run operation 2: with an argument, it will auto-play it: /- f256amp mp3/yourmp3file.mp3
run operation 3:  in f/manager, if you put this as <code>audioplayer.pgz</code> in the '_apps/' folder. This lets f/manager automatically open up .mp3, .wav, .ogg, .wma that you press enter on.
|-
|digestMidi
|converts .mid to .dim
|Mu0n
|pgz
|.mid files are slow to load, parse and prepare for a playback. This tool comes in to convert them into a .dim format that strips out unnecessary MIDI commands and sets it up for timer0 time delays. Works with type 0 and type 1 standard midi files. This tools does the conversion and lets you hear the result.
Find the latest version here: https://github.com/Mu0n/F256MiscGoodies/tree/main/apps
|-
|-
|EdInHisLib
|EdInHisLib
Line 145: Line 479:
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|FireJam
|all chips, music playing with MIDI in
|Mu0n
|pgz
|v1.2 MIDI in and out capable, it will still partially work with a Jr. (PSG, and SID if you have them), a K (PSG, SID, OPL3) and the newest wave 2 Jr2 and K2 (PSG, SID, OPL3, SAM, VS1053b).
Best to use with a MIDI in controller, but it'll be controllable with arrows and space to make notes individually, or the F keys to start beats. https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|-
|jrtracker
|jrtracker
|Tracker based in basic and uses the PSG
|Tracker based in basic and uses the PSG
(considered obsolete, use tracker2)
|contrerasd
|contrerasd
|basic
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|midiplayer
(aka 'cozyMIDI')
|Plays a SMF with the SAM2695 or VS1053b
|Mu0n
|pgz
|cozyMIDI can open and play type 0 and type 1 standard MIDI files (SMF)
needs a Jr2 or K2
v2.0 at https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
run operation 1: just as itself, it will force you to pick a midi file in the 'midi/' folder /- cozymidi
run operation 2: with an argument, it will auto-play it: /- cozymidi yourmidifile.mid
run operation 3: in f/manager, if you put this as <code>midiplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .mid files.
v2.1 now supports: loading files without having to quit the app + fully supports type 1 files with tempo changes now + file picker text UI + the 2x cores can run it given you stay with low memory settings given at bootup.
|-
|-
|modo
|modo
Line 157: Line 517:
|pgz
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|Musik
|Music piece demo using MIDI
|Mike
|pgz
|https://github.com/mcassera/Musik/blob/main/Musik.PGZ<nowiki/>Musikalisches Würfelspiel
Requires a Jr2 or K2 since it uses MIDI
|-
|-
|piano
|piano
Line 163: Line 530:
|basic
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]
1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF
2) run by first using superbasic's '''''bload''''' '''''"yourmusicfile", $01000'''''
followed by running this program with '''''/- playvgm.pgx'''''
|-
|testsuite.bas
|a series of tests for your F256, video modes and sound chips
|econtrerasd
|basic
|run from the root
|-
|tracker2 v1.5
|Like jrtracker.bas, but using both PSGs
|contrerasd
|basic
|https://github.com/econtrerasd/Tracker2/releases
|}
|}


== Utilities ==
== Uti<nowiki/>lities ==


{| class="wikitable"
{| class="wikitable"
|+
|+
!Program
!Program
!Description
!Descrip<nowiki/>tion
!Author
!Author
!Notes on running
!Notes on running
!Link
!Link
|-
|-
|wget
|basic2text
|fetches a file from a http address if you have a network connection active
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|gadget
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz/flash
|pgz/flash
|https://github.com/ghackwrench/F256_wget
|https://github.com/rmsk2/f256_dcopy
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks,  between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|f256_reset
|A small utility that lets you reset the machine through this piece of flash software
|mgr42
|flash
|https://github.com/rmsk2/f256_reset
|
|-
|fcart
|A program that allows to write data to flash expansion cartridges
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/cartflash
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|flashselect
|Allows to select a program to start from a flash cartridge via a menu
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/flashselect
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|midiStuff
|Test program for a F256K2 or F256Jr2 that sends MIDI data to the internal sam2695 dream chip that produces MIDI based audio. Also test a keyboard controller plugged in the MIDI in port.
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/blob/main/README.md#midistuff
|
|
|-
|-
|dcopy
|moreorless
|A tool to copy files from one drive to another
|A text editor for the Foenix 256 line of computers
|mgr42
|mgr42
|pgz
|pgz
|https://github.com/rmsk2/f256_dcopy
|https://github.com/rmsk2/moreorless/releases/
|
|-
|pgz2flash
|A program for your Linux, Windows or MacOS machine to turn any PGZ into a KUP which can be run from cartridge or onboard flash memory
|mgr42
|Executable for modern computers
|https://github.com/rmsk2/pgz2flash
|
|-
|sidTester
|Simple superbasic program that tests out all 3 voices of the SID1 on the Jr (if populated), K, Jr2 and K2. Ported by Mu0n, made by andy on HackJunk.com https://hackjunk.com/2017/11/07/commodore-64-sid-tester/
|andy
|basic
|https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/sidtester.bas
|
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active. Works with the K and Jr. ESP32 Feather 'huzzah' board. Not meant to be used with the K2 and Jr2 Wiznet chip.
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|}
|}


Line 198: Line 670:
!Notes on running
!Notes on running
!Link
!Link
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|-
|-
|cc65 example
|cc65 example
Line 210: Line 688:
|read github
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K asm doodles
|Some asm examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleASMdoodles
|-
|-
|Mu0n's F256K basic doodles
|Mu0n's F256K basic doodles
Line 216: Line 700:
|read github
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|Mu0n's F256K C doodles
|Some C examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleCdoodles
|-
|Raúl SQ basic repo
|F256 SuperBASIC Trigonometry
|Raúl SQ
|basic
|https://github.com/raul-sq/FoenixF256K2
|-
|-
|tcp example
|tcp example
Line 222: Line 718:
|$2000
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|https://github.com/ghackwrench/F256_example_tcp
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|}
|}

Latest revision as of 19:13, 25 August 2025

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it. For extra help on how to run .bin files and almost every possible scheme that has to be used to run program, you can consult this video that's also part of Getting Started, this one: https://www.youtube.com/watch?v=0ShFv89KGDs

Many download links are posts in the main Foenix Retro Systems discord server which will require you to join in order to get to them.

A Demo Archive was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

Curated SD card collection of games, demos, utilities

Here is a download link to a zip file meant to be extracted into the root of an SD card: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection

Best to wipe out your SD card and start anew with the contents of this extracted to root. Micah's file manager doesn't like long lists of files so it really is best to not overdo it. I tried to minimize the files in root, but I couldn't for everything.

Open the readme.txt file with moreorless to see some instructions about the collection. Best to run /- fm first, then open the readme.txt from it

Applications

Program Description Author Notes on running Link
F256-GraphicToolkit Sprite editor, Tilemap editor, Font editor + misc tools econtrerasd basic https://github.com/econtrerasd/F256-GraphicToolkit
F256 f/term Terminal emulator for F256K and Jr with classic (flat) memory load Micah - fterm.pgZ or use f/manager https://github.com/WartyMN/F256-terminal/blob/main/release/fterm.pgZ
FoenixTarot Tarot card readings in SuperBasic Mike basic https://github.com/mcassera/FoenixTarot/tree/main
Forthf256 Forth implementation Vasyl pgz in its forth/ folder https://github.com/VasylTsv/ForthX16

Demos

Program Description Author Notes on running Link
badapple A 80x60 textmode port of Bad Apple, uses the VS1053b for quality mp3 audio. Needs a Jr2 or K2! Mu0n pgz* *unzip badapple.zip into the root of your SD card. If done right, the 3 files within will be in the demos/ folder. The program expects its data file there when it runs. https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/badapple.zip
balls Draw a good quantity of multiplexed sprites, fast. Balls bouncing around celton pgz https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
F256Archon Splash screen intro, plays MIDI using the SAM2695, requires a K2 or Jr2 Mu0n pgz https://github.com/Mu0n/F256Archon/releases
f256_life An implementation of Conway's game of life mgr42 pgz https://github.com/rmsk2/f256_life
F256 Mandelbrot Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set. mgr42 uses basic loader https://github.com/rmsk2/F256_Mandelbrot
F256ShowCase Shows sliding tiling graphics, moves with joystick eriktier $0000 https://github.com/pig-games/F256Showcase
fnxmas23 PSG mod music, scrolling text, sound effects, must see demo! dwsJason and digarok pgz https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/xmas24_k2.pgz revised version that can run on wave 2 Jr2 and K2 as well
foenixmas23 Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo EMWhite uses basic loader http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
livingworlds Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale haydenkale $0000 https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
mandel Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program Mu0n basic https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
wormhole Shows a fast wireframe animation of a wormhole haydenkale pgz or bin at $0000 https://github.com/clandrew/wormhole?tab=readme-ov-file

Games

Program Description Author Notes on running Link
bbombers Boulder Bombers (Alpha-2) Clone of Canyon Bombers Scott (xDraconian) pgx

atari joystick

https://github.com/scttgs0/BoulderBombershttps://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
Bombsweeper Bomb sweeper port beethead pgz https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
Cosmic Shoot 'em up beethead pgz https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
F256-Trek Updated Trek, with modern F256 Graphics econtrerasd basic https://github.com/econtrerasd/Trek-F256/releases
F256 two to the power of eleven Port of the puzzle game of 2048 mgr42 pgz https://github.com/rmsk2/F256_2048
fillerup Fill 'er Up (WIP)

Qix-like game

Scott (xDraconian) pgx

atari joystick

https://github.com/scttgs0/Fill-er-up
FusionDrive An outrun type game that also plays a MIDI soundtrack Mu0n pgz wip v0.2, can use a NES pad #1 to move around, or left/right arrow keys currently https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
Jr Wördl port of Wordle AgeAgeEye basic https://github.com/ageageeye/Superbasic-F256Jr-examples
kartdemo Kart racing game SprySloth pgz https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
Lair of the Lich King Rogue like dungeon crawler. Demo has 3 levels; full has 25+ Micah - lkdemo/lk.pgz 1.0 Beta 19 Demo
livewire Livewire (WIP)

Tempest-like game

Scott (xDraconian) pgx

atari joystick

https://github.com/scttgs0/Livewire
Maze-Munch Pac-Man clone SprySloth pgz https://github.com/cmassat/Maze-Munch
pdefense Planetary Defense (WIP) Scott (xDraconian) pgx

mouse atari joystick

https://github.com/scttgs0/PlanetaryDefense
Shanghai/Mahjongg A clone of Shanghai. Also known as Mahjongg mgr42 pgz or KUP

mouse needed

https://github.com/rmsk2/f256_mahjong
Ski-Jr Ski game downhill digarok basic https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
Track & Field Olympic Game by Konami (WIP) Scott (xDraconian) pgz

atari joystick or keyboard

Tetris Good old 80's game Daniel Tremblay (Grenouye) pgz

atari joystick or keyboard

https://github.com/dtremblay/c256-tetris/tree/f256k

Game Jam #01 - April 6th/7th 2024

Program Description Author Notes on running Link
15puzzle Number sort puzzle mgr42 pgz https://github.com/rmsk2/f256_15puzzle/releases
Flight Simulator flying simulator sduensin pgz https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
frisbee Frisbee throw past sport game dwsJason pgz https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
Impasse Shoot 'em up digarok pgz https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
soccur mutliplayer game of soccer beethead pgz executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184

source code: https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232

Trek port of classic Star Trek game contrerasd basic https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
Typing Star typing reaction game haydenkale pgz https://github.com/clandrew/typestar

Game Jam #02 - October 25th-November 1st 2024

Program Description Author Notes on running Link
Bach's MIDI Hero Free MIDI/PSG play + note play tutorial Mu0n pgz

the MIDI feature requires a F256K2 or F256Jr2; a legacy PSG option also allows F256K and F256Jr to still hear it. Optionally uses a MIDI in controller plugged in.

https://github.com/Mu0n/F256KsimpleCdoodles/releases/download/v1.2/BachHero.pgz
f256_snake mgr42 pgz. Use cursor keys, Atari joystick or SNES pad to play https://github.com/rmsk2/f256_snake
fnxsnake silk-neon pgz https://github.com/ksiondag/fnxsnake
The Hallow beethead pgz https://github.com/noyen1973/FoenixGameJamOct2024
Halloween Birthday SprySloth pgz https://github.com/cmassat/GameJam2024_F256K
Haunted Mansion digarok superbasic https://github.com/digarok/fnxgamejam-haunted-mansion
Kooyan Grenouye pgz https://github.com/dtremblay/kooyan.git
Spooky Run dwsJason pgz https://github.com/dwsJason/spooky
Trick or Treat Mike pgz https://github.com/mcassera/TrickOrTreat
Ultima III - Exodus port Minstrel Dragon pgz https://github.com/minstreldragon/F256_Ultima_3
Warlock remake of 68000 game xDraconian pgz

atari joystick DOWN=change_level UP=jump UP-LEFT=leap UP-RIGHT=leap

https://github.com/scttgs0/Foenix_GameJam_Oct2024


Game Jam #03 - April 18th-April 27th 2025

Program Description Author Notes on running Link
Arcade Shanghai v1.2 Shanghai clone contrerasd basic, keep the .bas program in root, the rest in the provided ashanghai/ folder https://github.com/econtrerasd/ashanghai/releases
Bawk Bawk Cluck Cluck Chicken themed platformer beethead pgz https://github.com/noyen1973/FoenixGameJamApr2025
BitLadder Shoot 'Em Up Mu0n pgz. For full sound compatibility, a Jr2 or K2 is needed.

Uses 4 sound chips! (PSG, SID, OPL3, MIDI)

https://mu0n.itch.io/bitladder
F256_Commando Commando port SprySloth pgz https://github.com/cmassat/F256_Commando
F256_LodeRunner Lode Runner port Minstrel Dragon pgz https://github.com/minstreldragon/F256_Loderunner/releases
Mahjong Shangai clone mgr42 pgz https://github.com/rmsk2/f256_mahjong/releases
Quarth Block placement arcade game Grenouye pgz https://grenouye.itch.io/f256-quarth
Skee(ster)-Ball Mike pgz https://github.com/mcassera/skeeball256/tree/main

Music

Program Description Author Notes on running Link
audioplayer

(aka 'F256amp')

mp3, ogg, wav, wma file playback Mu0n pgz v2.1 Needs a Jr.2 or K2 since it uses the VS1053b chip. https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos

run operation 1: just as itself, it will force you to pick an audio file. it expects a mp3/ folder, but it can live without it and peek into the root instead.

run operation 2: with an argument, it will auto-play it: /- f256amp mp3/yourmp3file.mp3

run operation 3: in f/manager, if you put this as audioplayer.pgz in the '_apps/' folder. This lets f/manager automatically open up .mp3, .wav, .ogg, .wma that you press enter on.

digestMidi converts .mid to .dim Mu0n pgz .mid files are slow to load, parse and prepare for a playback. This tool comes in to convert them into a .dim format that strips out unnecessary MIDI commands and sets it up for timer0 time delays. Works with type 0 and type 1 standard midi files. This tools does the conversion and lets you hear the result.

Find the latest version here: https://github.com/Mu0n/F256MiscGoodies/tree/main/apps

EdInHisLib SID+OPL3 simultaneously beethead, ported from xantax pgz F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120

original: https://csdb.dk/release/?id=170898. Not 100% accurate but close.

FireJam all chips, music playing with MIDI in Mu0n pgz v1.2 MIDI in and out capable, it will still partially work with a Jr. (PSG, and SID if you have them), a K (PSG, SID, OPL3) and the newest wave 2 Jr2 and K2 (PSG, SID, OPL3, SAM, VS1053b).

Best to use with a MIDI in controller, but it'll be controllable with arrows and space to make notes individually, or the F keys to start beats. https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos

jrtracker Tracker based in basic and uses the PSG

(considered obsolete, use tracker2)

contrerasd basic https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
midiplayer

(aka 'cozyMIDI')

Plays a SMF with the SAM2695 or VS1053b Mu0n pgz cozyMIDI can open and play type 0 and type 1 standard MIDI files (SMF)

needs a Jr2 or K2 v2.0 at https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos


run operation 1: just as itself, it will force you to pick a midi file in the 'midi/' folder /- cozymidi

run operation 2: with an argument, it will auto-play it: /- cozymidi yourmidifile.mid

run operation 3: in f/manager, if you put this as midiplayer.pgzin the '_apps/' folder, f/manager will open midi file with it when you launch .mid files.

v2.1 now supports: loading files without having to quit the app + fully supports type 1 files with tempo changes now + file picker text UI + the 2x cores can run it given you stay with low memory settings given at bootup.

modo MOD player using the PSG dwsJason and digarok pgz https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
Musik Music piece demo using MIDI Mike pgz https://github.com/mcassera/Musik/blob/main/Musik.PGZMusikalisches Würfelspiel

Requires a Jr2 or K2 since it uses MIDI

piano Plays some PSG notes with the keyboard Mu0n basic https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
playvgm plays a headless vgm file with OPL3 G33kyAndIKnowIt pgx https://github.com/natebarney/playvgm-f256k

some example music files can be gotten from this post: https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074


1) open a normal .vgm into a hex editor and cut out the header bytes from 0x00 to 0xFF


2) run by first using superbasic's bload "yourmusicfile", $01000 followed by running this program with /- playvgm.pgx

testsuite.bas a series of tests for your F256, video modes and sound chips econtrerasd basic run from the root
tracker2 v1.5 Like jrtracker.bas, but using both PSGs contrerasd basic https://github.com/econtrerasd/Tracker2/releases

Utilities

Program Description Author Notes on running Link
basic2text A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you. Micah pgZ https://github.com/WartyMN/F256-BasText/releases/latest
dcopy A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable mgr42 pgz/flash https://github.com/rmsk2/f256_dcopy
f/manager A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz". Micah pgZ/flash https://github.com/WartyMN/F256-FileManager/releases
f256_reset A small utility that lets you reset the machine through this piece of flash software mgr42 flash https://github.com/rmsk2/f256_reset
fcart A program that allows to write data to flash expansion cartridges mgr42 pgz, on-board and cartridge flash https://github.com/rmsk2/cartflash
flashcart Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K redfool. basic https://github.com/Red-Fool/F256_FlashCart/tree/main
flashselect Allows to select a program to start from a flash cartridge via a menu mgr42 pgz, on-board and cartridge flash https://github.com/rmsk2/flashselect
fonts A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code. Micah (not a program) https://github.com/WartyMN/Foenix-Fonts
midiStuff Test program for a F256K2 or F256Jr2 that sends MIDI data to the internal sam2695 dream chip that produces MIDI based audio. Also test a keyboard controller plugged in the MIDI in port. Mu0n pgz https://github.com/Mu0n/F256KsimpleCdoodles/blob/main/README.md#midistuff
moreorless A text editor for the Foenix 256 line of computers mgr42 pgz https://github.com/rmsk2/moreorless/releases/
pgz2flash A program for your Linux, Windows or MacOS machine to turn any PGZ into a KUP which can be run from cartridge or onboard flash memory mgr42 Executable for modern computers https://github.com/rmsk2/pgz2flash
sidTester Simple superbasic program that tests out all 3 voices of the SID1 on the Jr (if populated), K, Jr2 and K2. Ported by Mu0n, made by andy on HackJunk.com https://hackjunk.com/2017/11/07/commodore-64-sid-tester/ andy basic https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/sidtester.bas
wget fetches a file from a http address if you have a network connection active. Works with the K and Jr. ESP32 Feather 'huzzah' board. Not meant to be used with the K2 and Jr2 Wiznet chip. gadget pgz/flash https://github.com/ghackwrench/F256_wget

Sample Code

Program Description Author Notes on running Link
Assembly examples Sample programs for several features of the Foenix F256K and Jr. mgr42 read github https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
cc65 example c example code gadget read github https://github.com/ghackwrench/F256_Jr_Kernel_DOS
digarok basic stuff Lots of basic examples digarok read github https://github.com/digarok/superbasic-traveler/tree/main
Mu0n's F256K asm doodles Some asm examples Mu0n read github https://github.com/Mu0n/F256KsimpleASMdoodles
Mu0n's F256K basic doodles Some basic examples Mu0n read github https://github.com/Mu0n/F256KbasicBASICdoodles
Mu0n's F256K C doodles Some C examples Mu0n read github https://github.com/Mu0n/F256KsimpleCdoodles
Raúl SQ basic repo F256 SuperBASIC Trigonometry Raúl SQ basic https://github.com/raul-sq/FoenixF256K2
tcp example connects to a server and gets typed in text echoed back to you gadget $2000 https://github.com/ghackwrench/F256_example_tcp