History

Evan Su c9fa476079 Add missing module		2021-08-09 11:39:39 -04:00
..
resources	Add files via upload	2021-08-01 22:48:36 -04:00
unstable	Begin v1.15	2021-08-07 17:54:27 -04:00
Picocrypt.go	Finalize v1.14	2021-08-07 16:40:01 -04:00
README.md	Add missing module	2021-08-09 11:39:39 -04:00

README.md

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 even easier with these simple instructions. I'll assume that you are familiar with the Go language and how to deal with modules.

1. Prerequisites

Linux:

sudo apt-get install -y gcc make libx11-dev libxcursor-dev libxrandr-dev libxinerama-dev libxi-dev libgl1-mesa-dev libxxf86vm-dev libgtk-3-dev xdg-utils libglu1-mesa xclip coreutils

macOS:

xcode-select --install

Windows: A C compiler, ideally TDM-GCC

2. Install the Go Programming Language

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

3. Get the Source Files

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

4. Get Resources

Place all the files in the resources directory above into the same directory as Picocrypt.go.

5. Create a go.mod

Go to where Picocrypt.go is located and create a go.mod:

go mod init Picocrypt

6. Install Dependencies

Install each of the following modules via go get -u -v:

golang.org/x/crypto
github.com/AllenDang/giu
github.com/HACKERALERT/serpent@v0.0.0-20210716182301-293b29869c66
github.com/HACKERALERT/infectious@v0.0.0-20210730231340-8af02cb9ed0a
github.com/HACKERALERT/clipboard@v0.1.5-0.20210716140604-61d96bf4fc94
github.com/HACKERALERT/dialog@v0.0.0-20210716143851-223edea1d840
github.com/HACKERALERT/browser@v0.0.0-20210730230128-85901a8dd82f
github.com/HACKERALERT/zxcvbn-go@v0.0.0-20210730224720-b29e9dba62c2

7. If You're Not on Windows

Windows requires a couple of extra lines to hide the command prompt window that shows when shredding a file. If you're not on Windows, however, you'll need to delete all occurrences of this line: cmd.SysProcAttr = &syscall.SysProcAttr{HideWindow:true}. You'll also need to remove the import of syscall.

8. Build From Source

Tidy the modules:

go mod tidy

Build Picocrypt 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

9. Done!

You should now see a compiled executable (Picocrypt.exe/Picocrypt) in your directory. You can run it by double-clicking or executing it in your terminal. That wasn't too hard, right? Enjoy!