Linuxndroid WhatsApp-View

A Python GUI application for extracting WhatsApp chat conversations from the app's SQLite database and viewing them in a simple, user-friendly desktop app.

Features

• Easy-to-Use GUI: No more command lines or running a web server. Just run the app and load your files.
• Light & Dark Modes: Includes a theme toggle for your comfort.
• Chat-Style Viewing: Reads all messages and displays them in a familiar sent/received chat bubble format.
• Contact Name Support: Automatically loads contact names from your wa.db file.
• Standalone: Can be compiled into a single .exe file for Windows, with no Python installation required.

---

How to Use (Recommended for Users)

You can download the pre-compiled application from the Releases page.

1. Go to the Releases page of this repository.
2. Download the latest Linuxndroid-WhatsApp-View.exe file.
3. Run the .exe file. (No installation is needed).
4. You will first need your decrypted database files. You can get them using WhatsApp-Key-Database-Extractor.
5. In the app, click the first "Browse" button to select your msgstore.db file.
6. Click the second "Browse" button to select your wa.db file (this is optional but provides contact names).
7. Click "Load Chats" and start reading!

---

How to Run from Source (For Developers)

If you prefer to run the script directly using Python:

1. Get Database Files: You must have your decrypted WhatsApp database files. Use Whatsapp Key Extractor for this.
2. Clone the Repository:

   git clone https://github.com/your-username/WhatsApp-Viewer.git
   cd WhatsApp-Viewer
   

3. Install Dependencies: This project only relies on Python's built-in libraries (like Tkinter). No pip install is required.
4. Run the GUI: Instead of main.py, you will now run gui.py:

   python3 gui.py
   

5. Use the application as described in the section above.

---

How to Build the .exe (For Developers)

If you want to compile the executable yourself:

1. Install PyInstaller:

   pip install pyinstaller
   

2. Add Your Icon: Place your desired icon file named icon.ico in the root of the project directory.
3. Run the Build Command: From the project's root directory, run the following command:

   pyinstaller --onefile --windowed --name "Linuxndroid-WhatsApp-View" --icon="icon.ico" gui.py
   

4. Find Your App: Your standalone Linuxndroid-WhatsApp-View.exe file will be in the newly created dist/ folder.

---

Disclaimer

Linuxndroid Provides no warranty with this software and will not be responsible for any direct or indirect damage caused due to the usage of this tool.
This tool is built for both Educational and Internal use ONLY.

Made with ❤️ By Linuxndroid

Credit

This project is an enhancement of the original CLI script by chrrel.

Follow Me on :