Skip to content

Home

Jump to bottom
Nin★ edited this page Mar 26, 2024 · 11 revisions
wiki-banner

Instructions

Basics

Assistant

Ninny ninny is the official assistant of Ninty Launcher:

  • When starting the launcher for the first time, she will give you an overview of the main interface and teach you what each option in the launcher settings does.

If you want to skip the introduction, just close the launcher and open it again.

  • If allowed, she will notify you about updates.

Navigation

Action Keyboard Key Gamepad Button
Browse through the library ◁, ▷ or A, D ◁, ▷ or L, R
Jump to the start / end of the library △, ▽ or W, S △, ▽
Move an entry in the library Shift X, Y or Select
Confirm Enter A or Start
Cancel Backspace B
Open search bar Spacebar n/a

Importing icons from the internet

When adding an application or game and an icon is not found automatically, the second window will ask you to provide one, you can import it directly from the internet:

  1. Search for the icon you want (must be in .png, .jpg or .gif)
  2. Copy its URL.
  3. Paste it in the name bar, then select open.

Changing the display title of an entry

  1. Select the application or game you want to change the title
  2. Click on the text showing its current title right above its icon.

Titles can only be 32 characters long.

Removing custom wallpaper

  1. Open the window to import a new wallpaper.
  2. When the window is visible, select cancel.

The current wallpaper will be removed from the launcher.

Changing clock system

Click on the text displaying your current time to toggle between 24-Hour and 12-Hour (AM/PM).

Locking the interface

To lock or unlock the interface:

  1. Hover your cursor over the clock icon in the upper-left corner.
  2. Click 3 times on the icon to toggle the interface locking.

With the interface locked, the following options will be restricted from modifications:

  • Entries in the library
  • Wallpaper
  • Launcher settings
  • Clock system

Backing up your data

Each user on your computer has its own profile when using the launcher.

If you are planning on switching accounts or devices, you can easily save your data to be restored later:

  1. Open the launcher settings (the gear icon in the bottom center).
  2. Select profile folder.
  3. It will open a directory in your file explorer, here you can copy all your files to a safe place.

  • What will be saved:

    • Library entries
    • Icons
    • Recorded time
    • Custom wallpapers
    • Personal settings

  • What will NOT be saved:

    • The files that your library entries uses to launch.
      • These being your applications and games files.

Troubleshooting

General solutions

The following steps can avoid/solve common problems regarding the overall functionality of the launcher:

  • Go to the .zip file you downloaded containing the launcher, right-click on it and go to Properties, check the Unblock box and click on the apply button, extract the launcher again and then, if possible, run it as administrator. This can solve problems regarding permissions.

  • Avoid storing the launcher and its files in directories with special characters in their names (E.g.: â,Ñ,ç,&.). If you are still having trouble when starting the application, try moving it to the main drive, usually C\. You can also try this for your applications and games installed in your library.

  • If the launcher seems to be stuck loading for too long or is unable to connect to the internet, it is likely that your system may be preventing the launcher from using certain features over the network, check your antivirus and firewall settings.

Specific solutions

• The interface is visually glitchy for me.

Go to the launcher settings and then toggle the interface rendering mode.

• My cursor isn't working properly, it can't reach certain parts of the interface.

If the problem is happening while in windowed mode, press ALT + Enter to switch to fullscreen mode, then go to the launcher settings and toggle the interface rendering mode, switch back to windowed mode and see if the cursor works correctly.

• I can't launch anything, but no error message appears.

First, make sure that you are using the latest version. If Ninty is downloading something (see if there is a connection icon in the upper-left corner of the interface) you will need to wait for this task to finish before launching anything. If it is taking longer than usual, the launcher may be having trouble to download certain files. this may be due to some restriction imposed by your firewall, see the General solutions section.

• When I try to start a game, it softlocks launcher.

Try to re-add the game to your library as a shortcut.

• When I start a game, the time is not recorded and the launcher is not minimized.

This feature works only with applications and games that only have a single window instance running. If you are trying to launch a game that already has its own launcher it will may not work, try to add it to your library as a shortcut instead.

• Forwarder embeds are not working.

If the application you are using as a forwarder needs a special parameter to execute embedded files, it will not work with Ninty automatically, you will need to set your own .bat file with the necessary parameters. If that isn't the case, the problem may be related to permissions, see the General solutions section.

• Rich presence is not working with some games.

If the game you launched has its own rich presence, it will always override the default one. For shortcuts, Ninty will not set a Rich Presence status.

• I updated Ninty, but the launcher is crashing when I try to start it.

Close the launcher, open your file explorer, in the address bar type %localappdata%\Ninty_Launcher and then press enter, delete all existing files except for the collection folder, then open Ninty again.

Advanced theming

Getting started

There are plenty of sample themes included with Ninty that you can use to create your custom wallpapers.

Recommendations

  1. Although there is no specific size, it is recommended to use a 16:9 aspect ratio (such as 1280x720) for your wallpapers.
  2. The song file should be in .ogg Vorbis, this the only format that will work with the launcher.
    • The file name must be the same as the image file for your wallpaper, so if your wallpaper is named mytheme.png, the song file should be named mytheme.ogg.
  3. Animated icons and wallpapers are loaded as an animation strip, so for all animations, each frame is next to each other in a single file.
  4. Don't make animations last too long, keep in mind that all frames are loaded into memory all at once, so very long animations can have a high performance impact.

Configuration reference

.ini

The configuration file must named after the image file of your wallpaper, so if your wallpaper is named mytheme.png, the configuration file should be named mytheme.ini.

[NINTY_WALLPAPER]

; Properties
theme = "1"
opaquebuttons = "1"
tiled = "0"
stretched = "0"
smooth = "1"

; Position
horizontal_offset = "0"
vertical_offset = "0"
horizontal_scrolling = "0.00"
vertical_scrolling = "0.00"

; Frames & Animation
animframes = "1"
animspeed = "0"

; Color HUE
huecolor = "0"
cursor_hue = "0"

; Keyframe A
cursor_luminosityA = "255"
cursor_saturationA = "255"

; Keyframe B
cursor_luminosityB = "64"
cursor_saturationB = "255"

Parameters

  • theme

Sets the base theme of the interface elements. 0 is light while 1 is dark.

  • opaquebuttons

The opacity preset of the buttons. Setting to 0 makes the buttons translucent while setting to 1 makes them opaque.

  • tiled

Determines whether the wallpaper should be repeated horizontally and vertically.

  • stretched

Stretches the wallpaper to the size of the window.

If enabled it overrides the tiled parameter.

  • smooth

Makes the wallpaper smoother when resized.

Ninty will automatically determine the level of anti-aliasing based on your screen resolution.

  • horizontal_offset
  • vertical_offset

Initial position of the wallpaper relative to the top-left corner of the window (in pixels). Negative values are allowed.

  • horizontal_scroll
  • vertical_scroll

Scrolling speed of the wallpaper in pixels. Negative values will make it scroll to the opposite direction, you can also use decimals.

  • animframes

The total amount of frames to animate.

  • animspeed

The time interval (in frames) in which the animation advance one frame.

Since the launcher runs at 60 frames per second, Setting to 60 will advance 1 frame every second, 120 to advance 1 frame every 2 seconds or 30 to advance 2 frames every second.

  • huecolor
  • cursor_hue

The base HUE of the interface (huecolor) and cursor (cursor_hue). See the image below:

example_hue

If set to 0, Ninty will use its default color.

  • cursor_luminosity_A-B
  • cursor_saturation_A-B

The luminosity and saturation components of the cursor.

You can use this HSL picker to get the components you want, you can perform the following calculations to make the HSL values compatible with your theme:

VALUE × (256 ÷ 360) - Converts 360º HUE (VALUE) to 256 units.
VALUE × (256 ÷ 100) - Converts saturation or luminosity percentage (VALUE) to 256 units.

A and B are used to animate the color saturation or luminosity, set both to the same value if you don't want them to be animated.

Database redirection

You can redirect where Ninty looks for icons by creating a file named NETWORK.cfg in the same directory as the launcher executable with the following content:

[REDIRECT]
appdb = "url"

url is where the URL of your database file goes. You can use the default database file as a template.

Clone this wiki locally