Editing Software

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.

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.  

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

== Applications ==
{| class="wikitable"
|+
!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
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|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
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|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://discordapp.com/channels/691915291721990194/934618943400837130/1188633998663098398 if you have Dec23 FPGA load or newer
https://discordapp.com/channels/691915291721990194/934618943400837130/1188633118194794527 if you have an older FPGA load
|-
|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 ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|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
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|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
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.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]
|-
|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]
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|-
|Track & Field
|Olympic Game by Konami (WIP)
|Scott (xDraconian)
|pgz
atari joystick or keyboard
|
|}

== 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/>
|-
|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
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|}

== 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
|https://github.com/Mu0n/F256KsimpleCdoodles/releases
|-
|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
|
|-
|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
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|jrtracker
|Tracker based in basic and uses the PSG
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|tracker2
|Same tracker, but using both PSGs
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/975117322836656138/1210809081577865257
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|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 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'''''<nowiki/> '''''"yourmusicfile", $01000'''''
followed by run<nowiki/>ning<nowiki/> this program with '''''/- playvgm.pgx'''''
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|-
|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
|https://github.com/rmsk2/f256_dcopy
|
|-
|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]
|
|-
|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
|
|-
|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
|
|-
|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
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|-
|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
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|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
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|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
|}