hex-viewer

A CLI-based python program allowing the user to pick a file and view it in hexadecimal. This supports files of any size and writes the output to a text file for debugging and analysis.

WINDOWS INSTRUCTIONS

1. If you haven't already done so, install Python here: https://www.python.org/

2. Afterward, install Hex_Viewer.py from the repository.

3. Open command prompt or PowerShell and navigate to the directory where you installed this. For example: cd C:\Users\user\Desktop\Hex_Viewer

4. Run the script with py Hex_Viewer.py or python Hex_Viewer.py

5. Alternatively, you may open the file in your preffered IDE.

6. Enter the file's name. If it is not in the same directory, enter the exact path to the file (INCLUDE THE FILE EXTENSION)

7. Windows Example: C:\Users\user\Desktop\example.dll Make sure you're entering your actual file's path. These are just examples for guidance.

8. OPTIONAL: After you're done viewing the hexadecimal code, you may open the file ending in .hex.txt for further analysis and/or debugging if you wish. It's created in the same directory as the script.

LINUX AND MAC OS INSTALLATION INSTRUCTIONS

1. If you haven't already done so, install Python here: https://www.python.org/

2. Download the script Hex_Viewer_MAC_Linux.py from the repository.

3. Open your terminal of choice and make sure you're in the same directory as the script (e.g. /home/user/Hex Viewer/Hex_Viewer_MAC_Linux.py)

4. Give the program executable permissions with the command: chmod a+x Hex_Viewer_MAC_Linux.py

5. From there, run the script in your preferred terminal: ./Hex_Viewer_MAC_Linux.py

6. Alternatively, you may open the file in your preferred IDE.

7. Enter the file's name. If it is not in the same directory, enter the exact path to the file (INCLUDE THE FILE EXTENSION)

8. Linux Example (Debian, Arch, Fedora, etc.): /home/user/Desktop/example3.txt Make sure you're entering your actual file's path. These are just examples for guidance.

9. MAC OS Example: /Users/user1/Documents/game.iso Make sure you're entering your actual file's path. These are just examples for guidance.

10. OPTIONAL: After you're done viewing the hexadecimal code, you may open the file ending in .hex.txt for further analysis and/or debugging if you wish. It's created in the same directory as the script.

PLANNED FEATURES

• Color coding specific patterns
• GUI for easier use
• Importing existing HEX patterns and exporting them
• Editing the HEX code and syncing the results