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.

Release 0.1 - Initial Release

Release 0.1 - Initial Release