Picocrypt/src/README.md

25 lines
2.2 KiB
Markdown
Raw Normal View History

2021-06-01 14:38:56 +12:00
# 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.
2021-05-30 07:38:13 +12:00
1. Prerequisites (only for Linux):
```bash
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
2021-05-30 07:38:13 +12:00
```
2021-05-31 03:31:36 +12:00
2. Install the Go Programming Language from <a href="https://golang.org/dl">here</a>, or from your package manager. Go 1.16 or higher is recommended.
3. Download the source file `Picocrypt.go` from above or `git clone` this repository.
2021-05-31 14:35:45 +12:00
4. Install Picocrypt's Go dependencies (if macOS prompts you to install clang, do it and run this command again):
2021-05-30 07:38:13 +12:00
```bash
2021-05-31 14:48:03 +12:00
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
2021-05-30 07:38:13 +12:00
```
5. Initialize Go and tidy the modules:
2021-05-30 07:38:13 +12:00
```bash
go mod init Picocrypt && go mod tidy
2021-05-30 07:38:13 +12:00
```
2021-05-31 03:31:36 +12:00
6. Go to where `Picocrypt.go` is located and build from source:
- Windows: <code>go build -ldflags "-s -w -H=windowsgui -extldflags=-static" Picocrypt.go</code>
- macOS: <code>go build -ldflags "-s -w -extldflags=-static" Picocrypt.go</code>
- Linux: <code>go build -ldflags "-s -w" Picocrypt.go</code>
2021-05-31 03:31:36 +12:00
7. You should now see a built executable (`Picocrypt.exe`/`Picocrypt.app`/`Picocrypt`) in your directory. 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`.
8. You are now complete. Go ahead and run the executable you just built. Enjoy!