A library to code in C or ASM for the Nintendo SNES

PVSneslib V4.1.0 (August,20,2023)

PVSnesLib (Programmer Valuable Snes Library) is an open and free library to develop programs for the Nintendo SNES using the C programming language.

Created initially for the 20th birthday of the Nintendo SNES (2012) and based on Ulrich Hecht SDK, it has been evolved a lot and is now mainly coded in assembler for performances reasons. It is also directly usable in asm for those who do not want to use C language but without rewriting everything from scratch.

It contains a snes-sdk compiler / linker and a library (sources included) which offer facilities to use backgrounds / sprites / pads / music & sound on the Nintendo SNES system. It also contains examples which demonstrate how to use the functions in the library.

Before getting started

First, you need to know that PVSnesLib uses the C language (assembly is possible and highly recommended for some speed aspects). It's highly recommended to be familiar with C programming before trying to develop with PVSnesLib. Learning C language at same time as learning Super Nintendo programming is definitely too difficult and you will end up getting nowhere. It's also important to have a good knowledge of the Super Nintendo hardware.

Here are good entry points to know how Super Nintendo works:

• SFC Development Wiki
• SNESdev Wiki
• Super NES Programming

Installation

To install the library, please download the latest release or with the link below and follow instructions on the Wiki pages.

You can also see the documentation generated from sources.

Visual Studio Code

You can find a Visual Studio Code template in the vscode-template folder to help PVSnesLib integration with it.

Build status

You can find with the link below the last stable builds of PVSnesLib. They are development builds, you can have bugs not yet resolved with them.

Dependencies and Docker

PVSnesLib works on Windows, Linux and MacOS systems.

For people who cannot work with the current builds of PVSneslib, you can build your docker image by following instructions available in the docker folder. Please see this wiki page to get all required dependencies.

To use it, you will need at least :

• a unix-like environment like msys2 if you work on Windows

If you want to compile the whole project, please see this wiki page to get all required dependencies.

Contribution

GitHub project

To discuss about the library, your project or to request help, join us on Discord.

PVSneslib and affiliated tools are distributed under the MIT license (see pvsneslib_license file).

Support PVSneslib

PVSneslib is free but you can donate to support its development:

Powered by PVSneslib

These projects are based on PVSnesLib (non-exhaustive list):

Yo-Yo Shuriken by Dr. Ludos

Eyra by Second Dimension

Sydney Hunter by CollectorVision

Special thanks

• RetroAntho for his great help to move wla-dx to last version and also for all compilation optimizations in Makefile, snes_rules and, at least, for keeping me motivated to update PVSnesLib 😉.
• Kobenairb for the port of python optimiser to c version, docker images, building scripts harmonisation and cleaning and the tcc-816 upgrade.
• Digifox and lunoka for their work on the intro logo.
• Ulrich Hecht for SNES C SDK.
• Byuu for bass, the assembler with SPC700 support.
• Mic_ for 816-tcc, sixpack, optimore and constify.
• Neviksti for pcx2snes.
• Shiru for snesbmp idea & sound tools.
• Mukunda for smconv tool.
• RedBug for constify tcc bug fix and tips for Linux and Docker.
• Mills32 for his mode7 3D example.
• N_Arno for his help on Linux version.

And, of course, all the discord community !

Thanks !