ihaveamac/ninfs v2.0a5

ninfs 2.0a5

on GitHub

This is the fifth alpha release for ninfs 2.0, with a new type and the return of the macOS standalone build.

This release is far from finished! It only has minimal testing. Some features are missing completely, some may not work correctly or at all.

This is a release that is the result of many internal changes under the hood over a year, and there are still more that are coming, before and after 2.0's full release. Testing this release is highly appreciated. Please file issues on GitHub. Support is provided on my server on Discord (info, invite link) or the thread on GBATemp. Thanks!

Note about Windows 7

Due to Microsoft discontinuing support for Windows 7, this platform is no longer supported. As soon as the standalone release is updated to use Python 3.9, it will not start. It should still work when used as a Python module, but issues specific to Windows 7 may not be fixed.

Additions and other changes

• A new type was introduced: iQue Player NAND backups (nandbb). Currently read-only. Thanks to @Jhynjhiruu for implementing this! #77
• The macOS standalone build is back and uses PyInstaller. It no longer automatically starts with Terminal. It also works when launched inside the DMG unlike before.
  • It is not ready for Apple Silicon / M1 devices! If you're using one, you might need to install Python, then install ninfs as a package with pip instead. (Or run from the repo.)
  • It's still not signed, so Gatekeeper will get in the way. On Big Sur you might need to control-click and choose "Open" twice to get the option to open it.
• Centralize all mount info into a module called mountinfo to make adding new types easier in the future. See DEVELOPMENT.md for details.
• Fix total size display
• Relax pyctr requirement to >=0.4,<0.5 (meaning any 0.4.X version)

Installation

Windows

The installer includes ninfs and WinFsp. This is the easiest way to use the application.

The standalone release can be downloaded as ninfs-2.0a5-win32.zip below the notes. Extract and run ninfsw.exe (or ninfs.exe to have a console attached).

ninfs can also be used as a Python module below.

macOS

macOS users need FUSE for macOS.

The standalone release can be downloaded as ninfs-2.0a5-macos.dmg below the notes. Open the disk image, optionally copy to the Applications folder, and run ninfs.

ninfs can also be used as a Python module below.

Linux

Install as a pip module like below. To use the gui, make sure tkinter is installed. This is python3-tk on Debian/Ubuntu and python3-tkinter on Fedora.

Arch Linux: (AUR git package still needs updates, please wait...)

BSD/etc.

No idea. It might work! I would like to make sure ninfs works on these systems too, so feel free to file issues or make PRs for compatibility with BSD or other systems that support libfuse.

fusepy should support FreeBSD and OpenBSD. For anything else you should consider adding support to refuse.

Python module installation

Python 3.6.1 or later is required. Version on PyPI

Windows

• py -3 -mpip install ninfs==2.0a5

macOS

The 10.6 variant of Python is not supported for Nintendo Switch NAND/NANDHAC types.

• python3 -mpip install ninfs==2.0a5

Linux

• python3 -mpip install --user ninfs==2.0a5
  • --user is not required if you are using a virtualenv.

A little something extra...

If my tools have helped you in some way then please consider supporting me on Patreon, PayPal, or Ko-Fi.