Kryptor
Search…
Kryptor
🏠
Introduction
📋
Features
💿
Installation
🎓
Tutorial
💻
Usage
❓
FAQ
⚠
Best practices
💀
Known limitations
🔎
Technical details
🛣
Roadmap
📓
Changelog
Powered By GitBook
💿
Installation

Downloading Kryptor

You can download Kryptor on the Introduction page.
Please follow the project on GitHub and regularly use the -u|--update option to check for updates. It is important to stay up-to-date for security and compatibility reasons.

Building Kryptor from source

Before you do anything with the source code, make sure you understand the GPLv3 license used by Kryptor.

Downloading the source code

  1. 1.
    Go to the latest release on GitHub and download the Source code (zip) asset.
  2. 2.
    Navigate to the download location and extract the ZIP file.
Do not download the source code from the master branch. The master branch often contains changes for the next version of Kryptor, which could render your build broken, buggy, and/or incompatible with release versions.

Using Visual Studio

  1. 1.
    After extracting the source code ZIP file, navigate to the src folder, and open the KryptorCLI.sln file in Visual Studio 2022 Community.
  2. 2.
    Right click on KryptorCLI in the Solution Explorer and click on Publish... .
  3. 3.
    Choose to publish Kryptor as either win-x64, linux-x64, or osx-x64. Then click Publish. You will find the published executable at the path listed next to Target location.
Note that the libsodium library requires the Visual C++ Redistributable for Visual Studio 2015-2019 to work on Windows. Therefore, you must keep the x64 vcruntime140.dll file in the same folder as kryptor.exe on Windows. However, as of v3.1.0, Kryptor automatically extracts this .dll file if it does not exist.
I do not recommend changing the publish profile settings, but you can tweak them to publish the application as framework-dependent, change the target location (output path), etc via the pencil icons.

Using the .NET CLI

  1. 1.
    Install the latest .NET 6 SDK.
  2. 2.
    Navigate to the src folder in the terminal (e.g. cd Downloads\Kryptor-3.1.1\src).
  3. 3.
    Copy and paste the following command for the operating system you would like to build for:

Windows (x64)

dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true -p:PublishTrimmed=true -p:IncludeNativeLibrariesForSelfExtract=true --self-contained true

Linux (x64)

dotnet publish -c Release -r linux-x64 -p:PublishSingleFile=true -p:PublishTrimmed=true -p:IncludeNativeLibrariesForSelfExtract=true --self-contained true

macOS (x64)

dotnet publish -c Release -r osx-x64 -p:PublishSingleFile=true -p:PublishTrimmed=true -p:IncludeNativeLibrariesForSelfExtract=true --self-contained true

Linux (ARM64)

dotnet publish -c Release -r linux-arm64 -p:PublishSingleFile=true -p:PublishTrimmed=true -p:IncludeNativeLibrariesForSelfExtract=true --self-contained true

macOS (ARM64)

dotnet publish -c Release -r osx.12-arm64 -p:PublishSingleFile=true -p:PublishTrimmed=true -p:IncludeNativeLibrariesForSelfExtract=true --self-contained true
The output path defaults to [project_file_folder]/bin/[configuration]/[framework]/[runtime]/publish/ .
A full list of .NET CLI publish options can be found here.

Verifying signatures

If you already have Kryptor installed, then you can use the previous version to verify the .signature file for your new download. If you do not have a previous version installed, then you should follow the Verifying digests section below.
You should not use the Kryptor version you just downloaded to verify the download signatures. Instead, you need to use a trusted, existing version.
  1. 1.
    Download the signature file for your version of Kryptor here.
  2. 2.
    Make sure the .signature file is in the same directory as the downloaded Kryptor .zip file.
  3. 3.
    Open the Command Prompt on Windows (e.g. search for cmd in the taskbar) or the terminal on Linux and macOS (e.g. search your programs for terminal).
  4. 4.
    Copy and paste the following command, replacing [file] with the file path of the Kryptor .zip file:
kryptor -v -y RWRudj7GpRdUxpojSmgHBOoNGUoD37H0WOUMAcT0yZcobg== "[file]"
Kryptor should display the message 'Good signature', followed by the authenticated comment 'Kryptor v[version]'.
If you see 'Bad signature', then your download is either corrupted or not legitimate and may be unsafe.​

Verifying digests

Windows

  1. 1.
    Download the latest .DIGEST file here.
  2. 2.
    Open a PowerShell window (e.g. search PowerShell in the taskbar).
  3. 3.
    Navigate to the directory of the downloaded Kryptor .zip file (e.g. cd Downloads).
  4. 4.
    Copy and paste the following command into the PowerShell window:
(Get-FileHash .\kryptor-windows.zip).Hash -eq (Get-Content .\kryptor-windows.zip.DIGEST).split(" ")[0].ToUpper()
The word True should appear in the PowerShell window.
If you see False, then your download is either corrupted or not legitimate and may be unsafe.​

Linux and macOS

  1. 1.
    Download the latest .DIGEST file here.
  2. 2.
    Open a terminal window (e.g. search your programs for terminal).
  3. 3.
    Navigate to the directory of the downloaded Kryptor .zip file (e.g. cd Downloads).
  4. 4.
    Copy and paste the following command, replacing [file] with the file name of the .zip file:
shasum -a 256 -c [file].DIGEST
The word OK should appear.
If you see another message, then your download is either corrupted or not legitimate and may be unsafe.​

Running Kryptor on Windows

  1. 1.
    Navigate to the location of the downloaded .zip file (e.g. the Downloads folder).
  2. 2.
    Right click the kryptor-windows.zip file and select Extract All.
  3. 3.
    Cut and paste (Ctrl + X) the kryptor.exe file into %USERPROFILE%, which can be accessed by searching %USERPROFILE% in the taskbar.
  4. 4.
    Open the Command Prompt (e.g. search for cmd in the taskbar).
  5. 5.
    Type kryptor -h for a list of commands and some examples. Please see the Tutorial for more information.
Do not move the kryptor.exe file into a directory that requires administrator privileges.

Running Kryptor on Linux

  1. 1.
    Open the terminal (e.g. search your programs for terminal) and navigate to the path of the downloaded .zip file (e.g. cd Downloads).
  2. 2.
    Type unzip kryptor-linux.zip.
  3. 3.
    Navigate to the extracted folder (e.g. cd kryptor-linux).
  4. 4.
    Mark the kryptor file as executable using chmod +x kryptor.
  5. 5.
    Move the kryptor executable to the /home directory using mv kryptor /home.
  6. 6.
    Type ./kryptor -h for a list of commands and some examples. Please see the Tutorial for more information.
Do not move the kryptor file into a directory that requires root privileges.

Running Kryptor on macOS

  1. 1.
    Open Finder and navigate to the path of the kryptor file (e.g. Downloads/kryptor-macos).
  2. 2.
    Right click on the kryptor file, choose Open, and click Open in the popup.
  3. 3.
    Close the TextEdit application.
  4. 4.
    Open the terminal (e.g. search your programs for terminal) and navigate to the path of the folder containing the kryptor file (e.g. cd Downloads/kryptor-macos).
  5. 5.
    Mark the kryptor file as executable using chmod +x kryptor.
  6. 6.
    Enter the command cd.
  7. 7.
    Move the kryptor executable to the /Users/USERNAME directory, replacing USERNAME with your user account name, which is shown before the @ symbol on the far left of the terminal (e.g. mv Downloads/kryptor-macos/kryptor /Users/samuellucas).
  8. 8.
    Type ./kryptor -h for a list of commands and some examples. Please see the Tutorial for more information.
Do not move the kryptor file into a directory that requires root privileges.
Previous
Features
Next
Tutorial
Last modified 3mo ago
Copy link
Outline
Downloading Kryptor
Building Kryptor from source
Downloading the source code
Using Visual Studio
Using the .NET CLI
Verifying signatures
Verifying digests
Windows
Linux and macOS
Running Kryptor on Windows
Running Kryptor on Linux
Running Kryptor on macOS