Release v2.0.4 - New GUI, Unified with CLI

Changes

• The GUI has been completely re-written using Wails.
• Both Windows and Linux (using Nautilus File Manager) now support automatically adding to the context menu.
• The CLI and GUI, while not sharing code, are now bundled in the same executable.

How to use the GUI

The GUI accepts the same arguments as the CLI but expects the first argument to be "gui", e.g. ./RCVT_Linux_amd64 gui <api-key> <file> will launch the GUI. After launching you can then install to the Right Click Context Menu.

How to use the CLI

CLI usage is unchanged, if the "gui" argument is missing, the program will run exactly the same as release 2.0.3

SHA-256 CHECKSUMS

---

12fcc0b4f95eb72352332db096dafdfadd66b577efe5bae920e2ee91d1913b00 RCVT_Linux_amd64
8d78e2b75c1be9a890f57127203c1b251f4a507d3927e07f2bd6f849b74d4f47 RCVT_Windows_amd64.exe

Release v2.0.3-beta - Versioning and Dynamic Title

Changes

• Version number is now featured in the help/default menu.
• If graphical title won't fit on the screen, it prints just "Title \n VERSION" instead.

SHA-256 CHECKSUMS

b2f1e24b453257a2d2bbb7c739583602aa082d365db55b119c0a40689b191c89 RCVT_CLI_Linux_amd64
f33ad07820f6bc5eaf8c7ffe592882f7ca536cb6ab8859069311077d204ba760 RCVT_CLI_macOS_amd64
50425a1e35264be70da6deb18cfa450495a0dcfaf321b4f2b200735aef4edd70 RCVT_CLI_macOS_arm64
6911d955f78dbb0618b080329cb2d2d723037462d88e14ffc81e9a3ae655cafe RCVT_CLI_Windows_amd64.exe

Release v2.0.2-beta - Fixes For Me Not For Thee

Fixes

• After completing --install it would request the API key again and repeat the process. Now exits after finishing install instead.
• Support for my preferred hyperland config custom alias files.

SHA256 CHECKSUMS

485852f20d1d00daf271ba8c417990b553150ad069df438d929bd029fb60b708 RCVT_CLI_Linux_amd64
a0e65cbe977bcd7d035ad067e67c5b94acfa56a492d136f60bd78317eb4c7f57 RCVT_CLI_macOS_amd64
4bf9bc2bb253878f82dd41986addd21466a74fe4165a2cea8b00b9f8510ec945 RCVT_CLI_macOS_arm64
3767e1d8b92d99ec21689d521e4209be46cdac1a41bfeef4a88246b9f3cbf741 RCVT_CLI_Windows_amd64.exe

Release v2.0.1-beta - A More Helpful CLI

Two new QoL features in this release, as well as a new build script which provides an executable for all (I hope) platforms.

Automatically Add as Alias

> ./RCVT_CLI_Linux_amd64 --install

Would you like to create an alias with your API key?
This will allow you to just type `rcvt <File>` in the future.
(Yy/Nn): y
Please enter your VirusTotal API Key: e7EdX4xWUPluP6iDNlUTEM57FCCF3Gig3lKDoFir8mL71fktlX03FseXI0q3jJHR
Appending alias to: /home/smp/.zshrc
Procced? (Yy/Nn): y

Alias added successfully!
Restart your shell, or run `source /home/smp/.zshrc` to use rcvt

Help Menu

> ./RCVT_CLI_Linux_amd64
  ___ _      _   _    ___ _ _    _  __   ___             _____    _        _ 
 | _ (_)__ _| |_| |_ / __| (_)__| |_\ \ / (_)_ _ _  _ __|_   ____| |_ __ _| |
 |   | / _` | ' |  _| (__| | / _| / /\ V /| | '_| || (_-< | |/ _ |  _/ _` | |
 |_|_|_\__, |_||_\__|\___|_|_\__|_\_\ \_/ |_|_|  \_,_/__/ |_|\___/\__\__,_|_|
       |___/                                                                 

Usage:
   <VirusTotalAPIKey> <FilePath>

Arguments:
  <VirusTotalAPIKey>  VirusTotal API key
  <FilePath>          Path to the file you want to scan

Options:
  --install           Create an alias with your API key for easier usage

Example:
  ./RCVT_CLI_Linux_amd64 YOUR_API_KEY file.exe

SHA256 CHECKSUMS

c25559f02981945f46afcf9d6287fcf9cf2ef4fc582f2660945ae6ca0eadc022 RCVT_CLI_Linux_amd64
43a4cfdd62726088f0cda225b2c2c0695fa48fe548cca998c0292d320717953d RCVT_CLI_macOS_amd64
62023d59bf72729b61218ee6da6466515d48c0226d0d5b29cef700fae164e487 RCVT_CLI_macOS_arm64
f24dbae0cafd25f37f4d60ae53d808b85ad91fe644f313bfdf63cab528013865 RCVT_CLI_Windows_amd64.exe

Release v2.0.0-beta - Universal CLI, better with Golang

This is the first beta release of the Universal CLI rewritten in Golang. No functional changes, the structure very closely follows that of the existing python version.

What makes it beta

Well it took me approximately two hours total to write from scratch, so I expect there will be issues somewhere. Mainly the error handling is not very graceful currently, if an error occurs it will just log and exit without any special sauce. But stay tuned for some stable releases, and releases of other versions in Golang.

Build Instructions

git clone https://github.com/smp46/RightClickVirusTotal.git 
cd RightClickVirusTotal/go
go build -o RightClickVirusTotal_CLI_Universal RightClickVirusTotal

SHA256 CHECKSUM

98dc7587d6441e6b6e2abd944663924b926c0468b920742457f635a7392b4162 RCVT_CLI_Linux_amd64
a767ee9dc333d7df74b9fa563a76af6e557eecd01a765c055c1bce5115652675 RCVT_CLI_Windows_amd64.exe

Release 1.4 - Final Python Release

This release is the (fingers crossed) final release of the Python version of RightClickVirusTotal.
There are no functional changes, but due to certificate expiry in the vt-py module (main dependency), all releases have been freshly built.
As this is the final release Universal versions have been compiled for both Windows and Linux x86.

Future releases will be written in Go for better performance and for the benefit of having real compilation. Stay tuned!

SHA256 CHECKSUM

20880e0836f16179c44f4f002662972eb9e1fe3adfaaeafd3035c2de4540be47 RightClickVirusTotal_CLI_Universal_Linux
a6869a95294177252c43012238d4ee259e1c255cfaab4edb8d96916cd4303845 RightClickVirusTotal_GUI_Universal_Linux
68c1ffeb1062ac8f1a3c1441439ffe45c062e7d32c762a3c3be1f96338fefa89 RightClickVirusTotal_GUI_Windows.exe
ae3272e6b310901cac23b1a598948b4bb902b373a4dec040c20b05dda927f381 RightClickVirusTotal_CLI_Universal_Windows.exe
729f310e011d743f98767c428314a4fdecdaa0812f5d83ddc72bafb705eabf89 RightClickVirusTotal_GUI_Universal_Windows.exe

Release 1.3 - Windows GUI Features

Big update for the Windows GUI version only, lots of improvements and new features specific to Windows:

• In the bottom right of the main window there is now a text button 'Add to Right Click Menu', clicking this will open a new window where you can enter your VirusTotal API key (or it will autofill it, if you launched the program with it in the arguments). Clicking submit will automatically add the program, in it's current location to the Windows right click context menu. Then the clickable text in the bottom right of the main Window will switch to 'Already in Right Click Menu' to indicate the program is present.

• To complement the above feature, you can now launch the program with no arguments in order to add it to the right click context menu.

• A link to this Github project on the bottom left of the page, so you can find instructions and keep up to date.

• A program icon, designed by myself, this icon will be used as both the program icon in the top left of the window and for the Windows right click context menu.

• Many bugfixes and stability improvements.

SHA256 CHECKSUM

bca76f260efcc2db777b9e9ff88d392069e2cc31b575d909f9d9d4f8591f0490 RightClickVirusTotal_GUI_Windows.exe

VirusTotal Report for the .exe

RightClickVirusTotal_GUI_Windows.exe

Release 1.2 - Better in Every Way

This release contains the new codebase utilising the vt-py module, and a compiled executable for every build.

SHA256 CHECKSUMS
9edfcd7887b739c780f9457c16593be3cb0448287a3cb29555f867490f0a3184 RightClickVirusTotal_CLI_Windows.exe
fb40d3f2c50ea7a0968e04575f63ff97da74e974b43904c79c95650b84d80cab RightClickVirusTotal_GUI_Windows.exe
213e6c6691b8cd665b9f09ff7dbe4a4093acea3c642b6115c541bbf6884d868b RightClickVirusTotal_CLI_Linux
cfd411f0d5fe5b973032a5f682138b16f524c28f005538da4ff2091d5790fc1d RightClickVirusTotal_GUI_Linux

Release 1.1 - Universal CLI

This release contains a Linux executable for the universal CLI version of the program.

MD5 CHECKSUM
e5521ccb31ad125daddb62664e35e038 RightClickVirusTotal_CLI_Linux

Basic Usage Instructions

Arguments must be provided to get the program to do anything., otherwise a usage error will be printed and program will exit.

The below example is for the Linux executable, but arguments are provided the same regardless of the platform.

./RightClickVirusTotal_CLI_Universal "VirusTotalAPIKey" "FilePath"

Ensure you replace the first argument, VirusTotalAPIKey, with your own API key and keep the quotation marks to ensure it is passed as a string. Then the second argument, FilePath, should be the whole path to the file, again also in quotes.

For example on Linux:

./RightClickVirusTotal_CLI_Universal "0010101010101abcdefq" "/home/smp/Documents/RightClickVirusTotal/realvirus.txt"

Current Issues

• None known.

Build Instructions using PyInstaller

1. Make sure you have PyInstaller installed. If not, you can install it using pip by running the following command: pip install pyinstaller

2. Install other required dependencies through pip:

   • requests
   • colorama

3. Open your terminal or command prompt.

4. Navigate to the directory where RightClickVirusTotal.py is located.

5. Run the following command to build the executable: pyinstaller --onefile RightClickVirusTotal_CLI_Universal.py

   This command instructs PyInstaller to create a single executable file that contains your program and its dependencies.

6. Wait for PyInstaller to finish the build process.

7. Once the build process is complete, you will find a new dist directory in the same location as your program file.

8. Inside the dist directory, you will find the executable file.

Release 1.0 - Functional

This release should be fully usable in it's current state, however it requires passing program arguments to do anything. Instructions below from readme that will likely be soon changing:

Basic Usage Instructions

With either the executable or the python script, arguments must be provided to get the program to do anything.

To use the program from the .py file on Windows:

python .\RightClickVirusTotal_GUI_Windows.py "VirusTotalAPIKey" "FilePath"

Ensure you replace the first argument, VirusTotalAPIKey, with your own API key and keep the quotation marks to ensure it is passed as a string. Then the second argument, FilePath, should be the whole path to the file.

For example:

python .\RightClickVirusTotal_GUI_Windows.py "0010101010101abcdefq" "C:\Users\smp\Documents\RealVirus.exe"

For the Windows executable file, the formatting of the arguments is the exact same however make sure to specify the .exe instead of .py file. Like this:

.\RightClickVirusTotal.exe "0010101010101abcdefq" "C:\Users\smp\Documents\RealVirus.exe"

Current Issues

• None known.

Build Instructions using PyInstaller

1. Make sure you have PyInstaller installed. If not, you can install it using pip by running the following command: pip install pyinstaller

2. Install other required dependencies through pip:

   • tk
   • ttkthemes
   • requests

3. Open your terminal or command prompt.

4. Navigate to the directory where RightClickVirusTotal.py is located.

5. Run the following command to build the executable: pyinstaller --onefile --noconsole RightClickVirusTotal.py

   This command instructs PyInstaller to create a single executable file (RightClickVirusTotal.exe on Windows) that contains your program and its dependencies.

6. Wait for PyInstaller to finish the build process.

7. Once the build process is complete, you will find a new dist directory in the same location as your program file.

8. Inside the dist directory, you will find the executable file (RightClickVirusTotal.exe on Windows).

Add to Context Menu in Windows 10/11

1. Open the Registry Editor by pressing Win + R, typing "regedit" in the Run dialog, and pressing Enter.

2. In the Registry Editor, navigate to the following key: Computer\HKEY_CLASSES_ROOT\*\shell\

3. Right-click on the "shell" key, choose New, and then Key. Give the new key a name that will represent your program (e.g., "Upload to VirusTotal").

4. With the newly created key selected, right-click on the right-side pane, choose New, and then Key. Name this key "command".

5. Select the "command" key you just created, and in the right-side pane, double-click on the (Default) value.

6. In the Edit String dialog box, enter the path to your executable followed by your API Key in quotes and "%1" (including the quotes).
   For example: "C:\Path\To\Your\Program.exe" "<APIKEY>" "%1"
   Make sure to replace "C:\Path\To\Your\Program.exe" with the actual path to your executable.

7. Click OK to save the value.

8. Close the Registry Editor.

After following these steps, you should be able to right-click on a file in Windows Explorer, navigate to the context menu option you created (e.g., "Upload to VirusTotal"), and your program will be launched with the file path as an argument.

Please note: Modifying the Windows Registry can have unintended consequences if not done correctly. Therefore, it's always a good idea to create a backup of your registry or create a system resore point.