nso-icon-tool

A switch homebrew which allows you to create user icons like NSO

Features
Screenshot
How to use
How to build
Help me
Credits

Features

Create and apply custom user icons using available NSO Icon Elements
Alternatively, use your own custom images as a user icon

Screenshot

More Screenshots

How to use

NSO Icons

Important

You must download the NSO Icon Cache from the settings page before they will be available. They aren't shipped with the application.

NSO Icon components are (usually) split into 3 parts: a frame, a character, and a background. Use the related button from the main page to browse the available icon parts (e.g. Select Frame lets your browse available frames).
Once you've created the icon, use Apply to User and it will be automatically applied to the selected user. This change won't be immediately visible everywhere on the switch; just how it works.

NSO Icon Cache

The icon cache contains all the NSO icon components. It must be downloaded in settings before they are available. This can take awhile the first time so be patient.
You can check for updates to the icon cache from settings. If new icons are available, you can downloaded the new cache and update your local copy if desired.
The cache is kept in sdmc:/avatars/nso-icons-main.
For speed, existing files aren't overwritten when updating the cache. If you have an issue, you can use Overwrite Existing Files During Update in settings to toggle this behavior.
Icon cache location: https://github.com/henry-debruin/nso-icons

Custom Images

Place any custom images (PNG or JPG) into sdmc:/avatars/ so they will be found. Sizing your images to 256x256 would be best, but incorrectly sized images will be resized automatically. This will likely not work well if the image width/height aren't equal.
Select Custom Images on the main screen in order to use your images.

How to build

Requirements

Docker

compose.yaml is provided which can be used with Docker as a build environment already containing the necessary requirements

Build

git clone --recursive https://github.com/dslatt/nso-icon-tool/
cd nso-icon-tool
cmake -B build_switch -DPLATFORM_SWITCH=ON
make -C build_switch nso-icon-tool.nro -j$(nproc)

git clone --recursive https://github.com/dslatt/nso-icon-tool/
cd nso-icon-tool
./proj_build.sh

Using MSYS2

You need a working DevKitPro installation and then install the packages:

MingW64:

pacman -Syuu git make cmake mingw-w64-x86_64-gcc switch-cmake libnx switch-dev switch-glfw switch-curl switch-libzstd switch-liblzma switch-lz4 switch-bzip2 switch-xxhash

MSYS

pacman -Syuu git make cmake gcc switch-cmake libnx switch-dev switch-glfw switch-curl switch-libzstd switch-liblzma switch-lz4 switch-bzip2 switch-xxhash

The commands to build are:

cd ~
rm -rf ~/nso-icon-tool
git clone --recursive https://github.com/dslatt/nso-icon-tool
cd ~/nso-icon-tool
./proj_build.sh

Help me

If you want to help me open an issue when you encounter a bug and a pull request if you have a fix. Thanks!

Credits

Special thanks to henry-debruin for creating nso-icons. There's no way this would have been made without your working pulling all the icons together that way!
Thanks to Natinusala, xfangfang and XITRIX for borealis
Thanks to nadrino for SimpleModManager and cpp-generic-toolbox
Thanks to XorTroll for Golfleaf
Thanks to HamletDuFromage for AIO-Switch-Updater
Thanks to PoloNX for SimpleModDownloader
Thanks to anyone who helped translate!

TODO

Bugfixes. I'm sure there's some.
Add some notification that an icon cache update is available on startup. Consider adding more details/clarity to the update process as well.
Add a collection of previously used/saved avatars for convienient switching.

andercard0 / nso-icon-tool