Skip to content

Samloader – Download Samsung Firmware on Mac/Win/Linux

When Samfirm was deprecated, Frija was released as an alternative. Since both the tools work only with Windows, macOS and Linux users found themselves in a no man’s land. Github user nlscc just released a Python-based tool called Samloader that can easily download Samsung firmware binaries (BL, AP, CP, and CSC) by fetching files from Samsung FUS (Firmware Update Server).  It’s a great Frija alternative that works flawlessly on Mac, Linux, Windows, and even Android. Follow this Samloader tutorial to learn how to use it on macOS, Linux, and Windows PC.

Being coded in Python, Samloader is a very tiny script (less than 50KB) and can be run via Terminal or Command Prompt on Mac, Windows, and Linux. Unlike Samfirm and Frija tools, Samloader has no GUI and that’s why noobs might find it a bit more complicated to use. The most striking feature of this minimal Samsung firmware downloader is its cross-platform compatibility. Besides, you can also download Samsung firmware on your phone or tablet with Samloader using apps like Termux and Terminal Emulator.

Features of Samloader

Samloader is a portmanteau formed by combining two words Samsung + Downloader. It is a simple Samsung Firmware download tool that gets its job done nicely. The utility is the result of reverse-engineering the process used by Samsung Smart Switch to authenticate the algorithms of the update server. Being based on Samfirm, Frija uses Windows DLL and an old algorithm that might stop working in the future. Samloader is an open-source project. Since it uses the latest algorithm from Smart Switch, it’s kind of a future-proof Samsung firmware download tool.

Here’s what Samloader can do:

  • Check the latest available firmware update for your Samsung device model.
  • Download the Samsung stock firmware from Samsung FUS in an encrypted format with ‘.zip.enc4‘ extension.
  • It can then decrypt the downloaded encrypted (enc2 or enc4) firmware into flashable packages namely, BL, AP, CP, CSC, and Home CSC.

Samloader will only download the BL, AP, CP, CSC, and Home CSC files that can be flashed using Samsung Odin.

Download Samsung Firmware on Mac

The unavailability of a proper Samsung firmware download tool and a firmware flashing tool for macOS has always been a problem for users. Samloader fills the void by giving us a great Frija alternative to download the latest firmware for Samsung devices using the Mac Terminal. You can then install the firmware using Heimdall or JOdin3 for Mac.

Let’s see how to install, set up, and use Samloader on Mac to check Samsung firmware updates and download them.

  1. Download the latest 64-bit Python installer for macOS.
  2. Double-click the downloaded python-3.9.0-macosx10.9.pkg file to install it.install python on mac
  3. Now launch the Mac Terminal. If you don’t know how to do that, navigate to Finder > Go > Utilities and click on Terminal.macOS: Go > Utilities
  4. Execute the following command in the Terminal window to clone the Samloader repository using Git.
    pip3 install git+https://github.com/nlscc/samloader.git
  5. Your Mac might prompt you to download an additional program called Git Installer. Samloader Git will be downloaded and installed on your computer.install samloader on mac
  6. You’ll get the “Successfully installed…” message in the Terminal. In case you get a warning telling you to upgrade the version of PIP, you can ignore it. However, if you wish to upgrade PIP, copy and paste the text highlighted in green (in the screenshot above) into the Mac Terminal window and hit the Enter key.upgrade pip on mac os
  7. Anyway, it’s time now to check for the latest available firmware update version for your Samsung smartphone or Galaxy Tab. Type the following command in the Terminal.
    samloader -m [model_number] -r [CSC] checkupdate
  8. For instance, if your Samsung device’s model number is SM-N986U, you should replace [model number] in the above code with SM-N986U. In the same way, you are supposed to replace [CSC]  with the CSC code of your Samsung device. Thus, the command you execute would look like this.
    samloader -m SM-N975F -r INS checkupdate

    samloader check firmware update mac os

  9. Samloader will return the latest firmware version available for your Samsung device. In my case, the firmware version for my Galaxy Note 10+ is
    N975FXXU6DTJ4/N975FOXM6DTJ4/N975FXXU6DTJ2/N975FXXU6DTJ4
  10. Now that you have the Samsung firmware version to download, you need to execute another command mentioning the device model number, CSC code, full firmware version you got above, and the location path on your computer where you want to save the firmware. If you have any problem typing the location path of a file or directory, check out my guide describing easy ways to find and copy file path on Mac.
    samloader -m [model_number] -r [CSC] download -v [firmware_version] -O [output_directory]
  11. Having replaced the required fields highlighted in the above command with actual information, your command should look like shown below.
    samloader -m SM-N975F -r INS download -v N975FXXU6DTJ4/N975FOXM6DTJ4/N975FXXU6DTJ2/N975FXXU6DTJ4 -O /Users/rakeshshukla/Desktop/
  12. Samloader will now connect and authenticate to the Samsung FUS and start downloading the firmware. You need to be patient; it’ll take a while to complete the download depending on your network speed.samloader download firmware on macos
  13. When the download is finished, you’ll see the encrypted firmware file in the output location or directory.
    SM-N975F_1_20201016232934_i2b0cuyqhv_fac.zip.enc4
  14. Since the downloaded Samsung firmware is encrypted, you need to decrypt it to get the Odin-flashable firmware binaries (BL, AP, CP, CSC, HOME_CSC).
  15. To decrypt the .enc2 (older firmware) or .enc4 encrypted firmware, use the following command.
    samloader -m [model_number] -r [CSC] decrypt -v [firmware_version] -V 4 -i [encrypted_firmware_name] -o [firmware_name]
  16. Replace the highlighted entries in the above code appropriately and paste the edited code into the Mac Terminal. In case the firmware you downloaded has .enc2 encryption, replace ‘4‘ in the above line with ‘2‘.
    samloader -m SM-N975F -r INS decrypt -v N975FXXU6DTJ4/N975FOXM6DTJ4/N975FXXU6DTJ2/N975FXXU6DTJ4 -V 4 -i SM-N975F_1_20201016232934_i2b0cuyqhv_fac.zip.enc4 -o SM-N975F_1_20201016232934_i2b0cuyqhv_fac.zip
  17. Samloader will now start decrypting the Samsung firmware and you’ll get a .zip file.
    SM-N975F_1_20201016232934_i2b0cuyqhv_fac.zip
  18. Just extract the firmware zip file to get all 5 binaries, namely BL, AP, CP, CSC, and Home_CSC.samsung firmware bl ap, cp, csc files

Done! You’re all set to flash  Samsung firmware on Mac using Heimdall.

How to Use Samloader on Windows

If you are a Windows user, you must have used Samfirm or Frija in the past to download Samsung firmware. Samloader is quite a new Python-based Samsung firmware downloader without any user interface. Let’s check out how to use it on a Windows PC.

  1. Download and install the stable Python release for Windows.
  2. Also, install Microsoft Visual C++ Tools because some Python libraries require it. If it’s not installed, you might get the following error.
    distutils.errors.DistutilsPlatformError: Microsoft Visual C++ 14.0 is required.
    Get it with "Build Tools for Visual Studio": https://visualstudio.microsoft.com/downloads/
  3. When it’s installed, also install Git for Windows. It’s required only if you want to install Samloader.git using the next step. You can skip this step otherwise.
  4. Launch the Command Prompt and execute the following command to clone Samloader Git on your PC.
    pip3 install git+https://github.com/nlscc/samloader.git
  5. Samloader will be installed on your Windows PC. In case you aren’t able to install Samloader this way, download the latest version from Github.

    download samloader

    Download Samloader from Github

  6. Extract the downloaded zip and open the extracted folder. Launch a Windows Powershell window inside the folder. Just type “cmd” in the ‘samloader-master‘ folder address bar and hit the Enter key to do that.samloader master folder
  7. When the command window is launched, issue the following command to install Samloader.
    pip3 install .

    samloader installation windows

    Install Samloader on Windows

  8. Alternatively, you can also install Samloader without launching the command window and navigating to the ‘samloader-master‘ folder.
    pip3 install <path-to-samloader>
    (such as: pip3 install C:\samloader-master)
  9. Now that Samloader has been installed on your PC, you can check for the latest update available for your Samsung Galaxy phone or Tab.
  10. Execute the following command in the command window. I’ve already attached the screenshots above.
    samloader checkupdate [model_number] [CSC]
    or
    samloader -m [model_number] -r [CSC] checkupdate
  11. Make sure that the command you issue to check the update looks like this. If you are not sure about the exact model number or CSC of your Samsung device, refer to our list.
    samloader checkupdate SM-N975F INS
    or
    samloader -m SM-N975F -r INS checkupdate
  12. Samloader will give the latest firmware version available for your Samsung Galaxy device.
  13. Now use one of the following commands to download the Samsung firmware. The ‘.‘ in the first command means that the firmware will be downloaded to the Samloader folder.
    samloader download [firmware_version] [model_number] [CSC] .
    or
    samloader -m [model_number] -r [CSC] download -v [firmware_version] -O [output_directory]
  14. Having replaced the highlighted fields with appropriate values, the command you execute should look like this. The first command will save the firmware file to the “samloader-master” directory, while the second will save it to your selected location.
    samloader download N975FXXU6DTJ4/N975FOXM6DTJ4/N975FXXU6DTJ2/N975FXXU6DTJ4 SM-N975F INS .
    or
    samloader -m SM-N975F -r INS download -v N975FXXU6DTJ4/N975FOXM6DTJ4/N975FXXU6DTJ2/N975FXXU6DTJ4 -O C:\Users\Rakesh Shukla\Desktop\
  15. Samsung firmware download will initiate and depending on your internet speed, it might take from some minutes to a few hours. Wait until the encrypted firmware gets downloaded.
  16. Once the Samsung firmware download is finished, you’ll have to decrypt it. While older Samsung firmware has .enc2 (decrypt2) encryption, the newer ones have .enc4 (decrypt4). To do that, you’ll have to use another command.
    samloader decrypt2/decrypt4 [firmware_version] [model_number] [CSC] [encrypted_firmware_name] [firmware_name]
    or
    samloader -m [model_number] -r [CSC] decrypt -v [firmware_version] -V 2/4 -i [encrypted_firmware_name] -o [firmware_name]
  17. Having replaced the highlighted values, the command you have to issue will be as shown below.
    samloader decrypt4 N975FXXU6DTJ4/N975FOXM6DTJ4/N975FXXU6DTJ2/N975FXXU6DTJ4 INS SM-N975F_1_20201016232934_i2b0cuyqhv_fac.zip.enc4 SM-N975F_1_20201016232934_i2b0cuyqhv_fac.zip
    or
    samloader -m SM-N975F -r INS decrypt -v N975FXXU6DTJ4/N975FOXM6DTJ4/N975FXXU6DTJ2/N975FXXU6DTJ4 -V 4 -i SM-N975F_1_20201016232934_i2b0cuyqhv_fac.zip.enc4 -o SM-N975F_1_20201016232934_i2b0cuyqhv_fac.zip
  18. Wait until Samloader decrypts the downloaded firmware. You’ll then be able to extract the firmware zip file to get the flashable firmware packages with .tar.md5 extension.

Having downloaded the firmware, you can use Odin to install the firmware on your Samsung device.

Don’t Miss: How to Check the Manufacturing Date of Samsung Devices

Fixing Samloader Not Recognized Error

If you have not set up Python and Samloader on your Windows PC properly, you might encounter the following error while checking for Samsung firmware update in the Command Prompt window.

samloader : The term 'samloader' is not recognized as the name of a cmdlet, function, script file, or operable
program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ samloader -m SM-N975F -r INS checkupdate
+ ~~~~~~~~~
+ CategoryInfo : ObjectNotFound: (samloader:String) [], CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException

You can easily fix the “Samloader is not recognized…” error by adding Samloader to the Windows command search path via the Environment variables setting on your PC and try again.

Using Samloader on Linux

Since I have already described the steps to use this fantastic cross-platform Samsung firmware downloader, there’s no need to repeat them. If you’re using one of the Linux distros, you can download Samsung firmware using Samloader. You can follow the steps given above for Mac. You can find the steps to install Python on Linux in this official Python installation documentation.

samloader on linux

Samloader on Linux

Having downloaded the Samsung firmware, you should download Odin4 for Linux and install the firmware binaries using commands.

This is all about Samloader, a Samsung firmware downloader for Mac, Linux, and Windows. In case you encounter any issues while following the steps given in this tutorial, please leave a comment below.

Read Next: Samsung Secret Codes You Must Check Out

6 thoughts on “Samloader – Download Samsung Firmware on Mac/Win/Linux”

  1. Hello, I believe I have managed to reproduce the steps correctly to acquire and decrypt the firmware on my Fedora 34 OS. However, when I tried extracting it in my Downloads folder, this error pops up: the file name with a ‘(null)’ beside it. One more detail would be the decryption process has 1024/1025 ‘items’ decrypted? Not sure how else to describe it, help is appreciated.

  2. Hi, I’ve been able to download the firmare file and decrypt it but when I try to unzip it I get the error:

    Archive: /home/dennis/tmp/SM-T700_1_20181210163007_qgobsvrvy5_fac.zip
    End-of-central-directory signature not found. Either this file is not
    a zipfile, or it constitutes one disk of a multi-part archive. In the
    latter case the central directory and zipfile comment will be found on
    the last disk(s) of this archive.
    unzip: cannot find zipfile directory in one of /home/dennis/tmp/SM-T700_1_20181210163007_qgobsvrvy5_fac.zip or
    /home/dennis/tmp/SM-T700_1_20181210163007_qgobsvrvy5_fac.zip.zip, and cannot find /home/dennis/tmp/SM-T700_1_20181210163007_qgobsvrvy5_fac.zip.ZIP, period.

    Any idea what may be happening here?

    Thanks, Dennis

  3. entered the following command in my Ubuntu 22.04 terminal “samloader -m SM-G988U1 -r INS checkupdate” I get the following message “samloader: command not found” I followed the instructions for the install

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.