Change platform specific instructions to generic

This commit is contained in:
Evan Su 2021-05-30 11:25:13 -04:00 committed by GitHub
parent ff7dc41a3d
commit 7966ac9d67
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -1,37 +1,24 @@
# Running From Source
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 very straightforward by writing specific instructions for each platform.
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.
# Windows
1. Install the Go Programming Language from <a href="https://golang.org/dl">here</a>.
2. Download the source file `Picocrypt.go` from above.
3. Install Picocrypt's dependencies:
```cmd
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 && 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
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
```
4. Open a Command Prompt in the directory which contains `Picocrypt.go` and build Picocrypt from source:
```cmd
go mod init Picocrypt && go mod tidy && go build -ldflags "-s -w -H=windowsgui -extldflags=-static" Picocrypt.go
```
5. You should now see `Picocrypt.exe` in your directory. Now, go and download the `sdelete64.exe` from the list above and place it in the same directory as `Picocrypt.exe`.
6. You are now complete and you can double click `Picocrypt.exe` to run Picocrypt.
# macOS
Coming soon....
# Linux
Coming soon....
## Other
If your distro is not Debian-based, don't worry! Building from source is still very simple.
1. Install the Go Programming Language from <a href="https://golang.org/dl">here</a>.
2. Clone this repository using `git clone` or by downloading the master branch.
3. Open a terminal where `Picocrypt.go` is located (in the `src` directory).
4. Get Picocrypt's dependencies:
2. Install the Go Programming Language from <a href="https://golang.org/dl">here</a>.
3. Download the source file `Picocrypt.go` from above or `git clone` this repository.
4. Install Picocrypt's Go dependencies:
```bash
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 && 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
```
5. Build from source:
5. Initialize Go and tidy the modules:
```bash
go mod init Picocrypt && go mod tidy && go build -ldflags "-s -w" Picocrypt.go
go mod init Picocrypt && go mod tidy
```
6. You're all done. You can now run the file `Picocrypt`.
7. 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>
6. 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`.
7. You are now complete and you can run the Picocrypt executable.