Skip to content

Release 1.0 - Functional

Choose a tag to compare

View all tags
@smp46 smp46 released this 31 Mar 09:47
· 52 commits to main since this release
v1.0
0fa39a3

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.

Assets 3
Loading