History

Evan Su b39d628966 remove external dependencies dir		2021-06-09 08:21:30 -04:00
..
archive	Update README.md	2021-06-07 15:45:23 -04:00
monocypher	Create README.md	2021-06-07 15:49:45 -04:00
unstable	Update README.md	2021-06-07 15:50:59 -04:00
Picocrypt.go	Test Github Actions	2021-06-07 14:39:04 -04:00
README.md	Fixed ordering	2021-06-01 22:27:55 -04:00
sdelete64.exe	Add files via upload	2021-03-26 11:45:45 -04:00

README.md

Running From Source (Work in progress)

If you would like to run Picocrypt from source, or an executable isn't available for your platform, you've come to the right place. Running from source is very simple, and I've made it even easier with these simple instructions. Note that the instructions are generic and will work on any platform.

1. Prerequisites

Linux:

sudo apt-get install -y gcc make curl git tar wget xz-utils libx11-dev libxcursor-dev libxrandr-dev libxinerama-dev libxi-dev libgl1-mesa-dev libxxf86vm-dev libgtk-3-dev xdg-utils && sudo apt-get install -y libglx-dev || echo "" && sudo apt-get install -y xclip || sudo apt-get install xsel

macOS (make sure Homebrew is installed):

sudo xcode-select --install && brew install glfw3 glew

Windows: No prerequisites

2. Install the Go Programming Language

Download the corresponding installer for Go from here, or from your package manager. Go 1.16 or higher is recommended.

3. Get the Source Files

Download the source file Picocrypt.go from above or git clone this repository.

4. Initialize Go:

Go to where Picocrypt.go is located and initialize Go:

go mod init Picocrypt

5. Install Picocrypt's Go Dependencies

go get -u -v github.com/pkg/browser && go get -u -v github.com/zeebo/blake3 && go get -u -v golang.org/x/crypto/sha3 && go get -u -v golang.org/x/crypto/argon2 && go get -u -v github.com/AllenDang/giu@v0.5.4 && go get -u -v github.com/OpenDiablo2/dialog && go get -u -v golang.org/x/crypto/blake2b && go get -u -v golang.org/x/crypto/blake2s && go get -u -v github.com/atotto/clipboard && go get -u -v github.com/klauspost/reedsolomon && go get -u -v golang.org/x/crypto/chacha20poly1305 && go get -u -v github.com/HACKERALERT/Picocypher/monocypher

Note: if macOS prompts you to install clang, do so and run the command again

6. Tidy the Modules:

go mod tidy

7. Build From Source

Windows: go build -ldflags "-s -w -H=windowsgui -extldflags=-static" Picocrypt.go
macOS: go build -ldflags "-s -w" Picocrypt.go
Linux: go build -ldflags "-s -w" Picocrypt.go

8. You are now complete.

You should now see a built executable (Picocrypt.exe/Picocrypt.app/Picocrypt) in your directory. You can run it by double-clicking or executing it in your terminal. If you're on Windows, go and download the sdelete64.exe from the list above and place it in the same directory as Picocrypt.exe.