Thanks to visit codestin.com
Credit goes to github.com

Skip to content

rashevskyv/kefir

Repository files navigation

Kefir

Українською

What is Kefir

This is a collection consisting of modified Atmosphere, necessary programs and scripts that install everything correctly. It was created to facilitate the installation and maintenance of software on a hacked Nintendo Switch. The changes made to Atmosphere are aimed at improving the quality of using the system itself.

Main differences from vanilla Atmosphere:

  • Kefir versions alongside system versions
  • Installation of exFAT memory card driver by default when updating the system
  • Removal of ACID signature verification for using homebrew without patches
  • Removal of system logging to prevent memory card cluttering and excessive usage
  • Redirection of saves from internal memory to memory card when using emuNAND to reduce the probability of losing them if emuNAND fails (optional)

Kefir is not a firmware! It's a collection consisting of Atmosphere firmware and the necessary minimum of recommended programs, plugins, modules and other software.

Why do you need Kefir?

First of all, Kefir is needed to simplify the user's life. That is, if the user has the recommended version of system software and the latest version of Kefir, then everything should work for them. It can be said that the user is in controlled conditions. It's enough to name the version of the system software and Kefir, and it immediately becomes clear what is approximately installed in the system.

Kefir composition

  1. Kefirosphere, a fork of Atmosphere
  2. Signature patches. Thanks to them, you can run unsigned (read: pirated) programs and games on Atmosphere.
  3. Bootloader hekate: Thanks to the bootloader, you can launch firmware and other payloads through a convenient menu, create and restore NAND backups, make EmuNAND, get information about the system state, mount the memory card to PC without removing it from the switch, repartition the memory card for installing other OSes, and much more
  4. Installed payloads:
  • Lockpick_RCM - program for dumping console keys
  • TegraExplorer - file manager for Switch in the form of a payload. Analog of GodMode9 for 3DS
  1. Installed Homebrew
  • DBI - program for installing games via USB or from memory card
  • Tinfoil - program that allows downloading games for the console directly from the network
  • Kefir Updater - program for updating kefir via internet
  • Sphaira - environment for running homebrew, downloading themes and applications on switch, file manager
  • Daybreak - program for safe updating of the console's system software version
  • NXThemes Installer - custom themes manager
  • Linkalho - program for linking account
  1. Installed modules. Modules are additional components that work inside Atmosphere and allow you to do various cool things, for example, using Xbox-compatible controllers, amiibo emulation, overclocking, etc. Unfortunately, SX OS does not support modules
  • sys-con - module that allows connecting almost any gamepad to the console via USB
  • Mission Control - module that allows connecting almost any gamepad to the console via bluetooth
  • Uberhand - special overlay menu for system interaction with support for custom scripts and modules
    • Scripts:
      • DBI - changing localization and updating the program
      • Translate Interface - additional interface translations to choose from
      • Semi-stock - loading into semi-stock from the menu
      • Reboot and Shutdown - restarting and shutting down the console from the menu
    • Modules:
      • nx-ovlloader - process for working with nro through Tesla Menu
      • ovlEdiZon.ovl - Module for using cheats
      • ovlSysmodules.ovl - Module for enabling and disabling installed system modules (e.g., overclocking, emuuibo, etc.)

Instructions for installing/updating kefir

First installation or installation on a clean memory card

  1. Copy the contents of the kefir.zip archive from the repository to the root of the console's memory card
  2. Insert the memory card into the Switch
  3. Launch the console into firmware, according to your hack type. payload.bin - the payload that needs to be injected when launching the console via Fusée Gelée, is located in the archive with the collection

Updating kefir or transitioning from another collection

Manual installation instructions (all OS)

Connecting the console's memory card to PC

If you are a MacOS user, follow the recommended steps to avoid problems with the memory card.

If the console is turned off, insert the memory card into the PC. If it's turned on:

  1. Restart the console through the menu that is called by holding the (POWER) button
  2. On the kefir splash screen, press the volume down button to get to hekate
  3. Now you can remove the memory card from the switch and insert it into the PC.

When removing the memory card in hekate, you won't need to re-inject the payload to enter the firmware. Just insert the card into the console and launch the firmware through the Launch menu

Installing kefir (all OS)
  1. Copy the contents of the kefir.zip archive from the repository to the root of the console's memory card
  2. Insert the memory card back into the Switch
  3. In hekate, select More configs -> Update Kefir
  4. After the installation is complete, the console will boot into the firmware

You can also simply turn off the console, remove the card from it, copy kefir onto it with replacement, then insert the card back into the Switch and turn on the console. In this case, the update script will be launched automatically

Updating kefir directly on the console (kefir version 529 or higher)

  1. Launch HBL
  2. Select Kefir Updater (Internet connection required!)
  3. Click "Update Kefir", click on "Kefir [version]", select "Download"
  4. Wait for the download and unpacking to complete, then click "Continue". The console will reboot into the payload, after which the kefir installation process will begin
  5. After the installation is complete, press any button to load the console into the firmware

Clean kefir installation (recommended when errors occur)

  1. Delete everything from the card except the Nintendo and emummc folders, if they exist
  2. Install kefir using a convenient method described above

Debugging kefir installation (recommended if a clean installation didn't help)

  1. Copy the Nintendo and emummc folders, if they exist, to PC
  2. Format your memory card in FAT32 and return the folders back
  3. Install kefir using a convenient method

Troubleshooting

If you encounter a [NOFAT] error or any other problem with updating through the kefir-updater script, use the kefir installation through install.bat:

  1. Unpack kefir.zip to any convenient location on PC, except the console's memory card
  2. Insert into PC the console's memory card
  3. Run install.bat from the folder where you unpacked kefir.zip and specify the letter of your memory card
  4. Wait for the copying to complete
  5. Insert the card into PC and launch the firmware

If you get the "Is BEK missing" error, turn off the console and turn it on again.

Launching Atmosphere

If after entering the firmware the console doesn't see the card and requires a firmware update for it to work, or simply hangs on a black screen after the Nintendo logo, then your console doesn't have exFAT drivers installed! Format the memory card in FAT32.

In hekate, autoboot is set by default. That is, when the console starts, the hekate menu will not be displayed, but the firmware will start immediately. To go to the hekate menu, hold (VOL-) during the splash screen appearance.

Important Information!

  • Reboot to hekate happens directly from the firmware, through the normal reboot menu. Just hold (VOL-) during the kefir splash screen
  • You can access your memory card without removing it from the console via MTP (DBI -> Run MTP Responder), or through hekate (does not work correctly for everyone, it is impossible to update kefir via MTP)
  • Installing and updating kefir are done the same way!
  • If you encounter the "Is BEK missing" error, turn off the console and turn it on again.

Additional Information

  • To work with modules (sys-con, Mission Control, etc.) in kefir, Uberhand is installed - a special overlay menu for interacting with the system. To activate it, press (L) + d-pad down + (R3)
  • To switch to semi-stock
    • From the firmware itself: go to Uberhand ((L) + d-pad down + (R3)), press right > Semi-stock
    • When starting the console: Navigate to hekate and select More-configs > Semi-stock (blackscreen fix)
    • Note that when launching from firmware, the installed theme will be disabled, which will help avoid errors if there are different versions of system software and emuNAND on the console
  • You can update kefir using the Kefir Updater utility

Overclocking

  • Enabling To activate overclocking, go to Uberhand ((L) + d-pad down + (R3)), press right > Settings > Use overclock
  • Disabling To disable overclocking, go to Uberhand ((L) + d-pad down + (R3)), press right > Settings > Disable overclock

8GB Memory Support Mode

  • Enabling
    • To enable, go to Uberhand ((L) + d-pad down + (R3)), press right > Settings > Enable 8GB support
  • Disabling
    • To disable, reinstall kefir using a convenient method

Kefir's sources moved here - bitbucket, kefir binary on releases

Donate to kefir's dev

Paypal

PayPal

Банка monobank

mono

Donate for support Ukraine

🇺🇦 UKRAINE NEEDS YOUR HELP NOW!

I'm the creator of this project and I'm Ukrainian.

My country, Ukraine, is being invaded by the Russian Federation, right now. I've fled Ivano-Frankivs'k and now I'm safe with my family in the western part of Ukraine. At least for now. Russia is hitting target all over my country by ballistic missiles.

Please, save me and help to save my country!

Ukrainian National Bank opened an account to Raise Funds for Ukraine’s Armed Forces:

SWIFT Code NBU: NBUA UA UX
JP MORGAN CHASE BANK, New York
SWIFT Code: CHASUS33
Account: 400807238
383 Madison Avenue, New York, NY 10179, USA
IBAN: UA843000010000000047330992708

Come Back and Alive found (savelife.in.ua)

BITCOIN
bc1qkd5az2ml7dk5j5h672yhxmhmxe9tuf97j39fm6

ETHEREUM (eth, usdt, usdc)
0xa1b1bbB8070Df2450810b8eB2425D543cfCeF79b
0x93Bda139023d582C19D70F55561f232D3CA6a54c

TRC20 (tether)
TX9aNri16bSxVYi6oMnKDj5RMKAMBXWzon

Solana (sol)
8icxpGYCoR8SRKqLYsSarcAjBjBPuXAuHkeJjJx5ju7a

You can also donate to charity supporting Ukrainian army.

THANK YOU!