Giter Club home page Giter Club logo

fluffy's Introduction

Fluffy

intro 查看中文使用说明,请点击这里!

Features

  • Support for XorTroll/Goldleaf and Adubbz/Tinfoil
  • Support for languages: English, Chinese, Vietnamese, Spanish, French, Brazilian Portuguese, Turkish, Italian and German!
  • Ability to abort an installation in queue.
  • USB and Network Install, display transfer rate in MB/s and progress percentage.
  • USB and Network Install, display current NSP being installed.
  • Goldleaf: Display current NCA being installed.
  • Goldleaf: Display current NCA queue.
  • Transfer modes between "Normal" and "Safe".
  • Smart User-Interface, switches between Tkinter and PyQt depending on modules installed. (v1.4.1 and below only)
  • Support for UI scaling on 4K, 1080P, and 720P displays.
  • Show current NSP being installed.
  • Individual NSP selection (suggest by: Shadowhand, thanks!).
  • Tasty donut.
  • Switch connected indicator.
  • 5.x USB Fix (Thanks to satelliteseeker)

Screenshot

screenshot

Instructions For Use

Install TinFoil on your Switch

  • These steps apply for all custom firmware. This includes but not limited to: Kosmos, ReINX, SXOS, etc.
  • Download Recommended TinFoil
  • Copy and paste "TinFoil.nro" to a folder named "Switch"(create it if necessary) on the root of your SD card.

Windows instructions

1/3) Install and Setup Zadig Driver

  • Download Zadig: https://zadig.akeo.ie or github mirror in case the website goes down.
  • With your Switch plugged in to your PC using a USB-C cable, open TinFoil(on your Switch). This will ensure your Switch is visible.
  • Open Zadig > Options > List All Devices.
  • In the scroll box above the button "Install Driver", tap the arrow until arriving at "libusbK".
  • Click "Install Driver"
  • Done!

2/3) Install Python

  • Download and Install Python 3 from Python Website. Select the "PATH" option during install. Ensure no previous version of Python is installed and do not use the 64-bit version of Python 3. This may cause an error "PyUSB not found". Also be sure to include Tkinter with your installation(it should be a default option).

3/3) Install PyUSB, LibUSB, PyQt5, QDarkStyle

  • Open Command-line/CMD (Start, search "CMD") and run the following:
pip3 install pyusb pyqt5 libusb libusb1 qdarkstyle

Additional Windows Instructions

Some users may receive the error "USB.Core No Backend Available". If you do, download this .DLL file libusb.dll and place it in the same directory as Fluffy.pyw.

If you still receive this error, you can try installing LibUSB: libusb installer.

Linux instructions

Ubuntu/Debian based distributions

1/2) Install Python and Dependencies

  • Required: python3 python3-pyusb python3-pyqt5 python3-tk python3.6-tk libusb libusb1 qdarkstyle.
  • Install Python3:
  • sudo apt install python3 python3-pip python3-tk.
  • Then open Terminal and run this command:
  • pip3 install pyusb pyqt5 libusb libusb1 qdarkstyle.

2/2) Download Fluffy and Switch Rule

Download the latest Fluffy.pyw and 80-fluffy-switch.rules.

Open Terminal and change into the directory where these files are located using the cd command:

cd /path/to/fluffy/

Copy the file 80-fluffy-switch.rules to /etc/udev/rules.d/ using this command:

sudo cp 80-fluffy-switch.rules /etc/udev/rules.d/

Then give both the proper permissions:

sudo chmod 644 /etc/udev/rules.d/80-fluffy-switch.rules
sudo chmod 755 fluffy.pyw

Arch/Manjaro/Antergos

Install the AUR package fluffy-switch maintained by YoyPa.

Installation and Application Launcher (Optional)

You may wish to Install Fluffy. Download the latest Fluffy.pyw and 'icon.ico' and 'install.sh' from here. Extract and move each file into a single folder.

Installation is then as simple as:

cd /path/to/files/
sudo ./install.sh

MacOS instructions

 brew install libusb 
 brew reinstall python --with-tcl-tk

For more info on brew, head to https://brew.sh/

How-To-Use

Complete beginner? No problem.

  • First follow the installation steps above. Done? Let's continue!
  • On your Switch running Custom Firmware open TinFoil > Title Management > USB Install NSP.
  • Double-click on Fluffy.pyw to start it (Linux users: type fluffy in your start menu or terminal).
  • Click "Select NSPs" and select as many NSPs as you want to install.
  • If "Switch Detected!" is visible. Click "Begin Transfer".
  • On your Switch, select and install the NSPs.

Troubleshooting Tips

Why do I keep getting the error: "USBCore No Backend Available"?

Answer: This can be caused by 1-2 things.

  1. Not all USB type C cables will work with the Switch. If your Switch connects then frequently disconnects, then reconnects again, etc. Or if you receive this error, it's highly likely you will need a newer USB type C cable. Yes, there are differences despite being visually similar.

  2. LibUSB wasn't found. Install it with "pip3 install libusb" and "pip3 install libusb1". Also follow the above steps labeled "Additional Windows Instructions".

Why do I keep getting the error: "No module named 'PyQt5'"?

Python by default wants to run in 64-bit mode, however, when this happens Fluffy won't work. As you may already know, Fluffy does not, will not, and cannot run in 64-bit Python. To bypass this behavior you can alternative open Fluffy.pyw in IDLE(32-bit mode) and click Run > Run Module.

Why does network install fail?

Answer: Network install is a hit or miss depending on your setup. Try forwarding port 2000 in your router and disabling your firewall. Ensure your Switch and PC are on the same network.

PyUSB Not Found and I've followed all the steps!

Answer: Fluffy only works with Python 3 32-bit version. Also be ensure no previous versions of Python are installed. If necessary, uninstall them. For example, if you have Python 3.6.6 and Python 3.7.2 installed at the same time Fluffy may throw this error.

What kind of cable does the Switch use?

Answer: USB type C cable. Though, not all USB type C cables are the same. Some will not be compatible with the Switch.

Does Fluffy work on MacOS and Linux?

Answer: Absolutely! Python is cross-platform and so Fluffy should work on both operating systems.

Which Custom Firmware works best with Fluffy and TinFoil?

Answer: All of them will work the same. That is up to you.

Why does my install keeps hanging and/or crashing?

Answer: Switch Transfer Mode to "Safe".

Why do I have unsufficient permission error (usb)(linux)? (credit: YoyPa)

Answer: You need to make a udev rule to modify the switch usb device permission in /etc/udev/rules.d/

Still having problems? Consider making a bug report on this GitHub page to request assistance.

Disclaimer: The "Pink Donut" design was designed by fourminute exclusively for Fluffy and infringes on no copyright. The font used in "intro.png" is also 100% royalty free.

fluffy's People

Contributors

danypava avatar davidolim avatar fourminute avatar gut5 avatar sev73n avatar thezoc avatar torpedoxl avatar yoypa avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.