- Overview
- Features
- Prerequisites
- Installation
- Usage
- Project Structure
- Contributing
- Troubleshooting
- Changelog
- License
- Contact
Hermes is a powerful tool designed to securely extract and view iMessages from macOS devices. It provides a user-friendly interface for accessing and managing your iMessage data, ensuring privacy and ease of use.
- GUI Viewer: Intuitive interface for browsing and searching messages
- Secure Extraction: Safely extract iMessages from macOS devices
- Export Functionality: Export conversations or selected messages
- macOS device with iMessages enabled
- Python 3.x
- Homebrew (for easy Python installation)
To set up Text Message Forwarding from your iPhone to your Mac, follow these steps:
-
Access Settings on iPhone:
- Open
Settings
. - Navigate to
Messages
.
- Open
-
Enable Text Message Forwarding:
- Tap on
Text Message Forwarding
.
- Tap on
-
Verify Account Consistency:
- Note: If you do not see the Text Message Forwarding option, ensure that you are signed in with the same Apple ID on both your iPhone and your Mac.
-
Select Your Mac:
- Turn on the option for your Mac listed under devices.
-
Authentication:
- If you are not using two-factor authentication, a six-digit activation code will appear on your Mac.
- Enter this code on your iPhone and tap
Allow
to authenticate.
Conda is an open-source package management and environment management system. It functions like a library, where you can easily access and manage collections of software packages without conflicts.
-
Install Homebrew: If you do not have Homebrew installed, run this line in your terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-
Install Python: Once Homebrew is installed, you can install Python by running:
brew install python
-
Verify Python Installation: After installation, you can verify that Python is installed correctly by checking its version:
python3 --version
-
Set Up Python Environment (Optional): If you need to manage multiple Python environments, you can install
pyenv
using Homebrew:brew install pyenv
Then you can create a new environment, for example with Python 3.9:
pyenv install 3.9.1 pyenv global 3.9.1
-
Update PATH: Ensure that the Homebrew Python version is used when you run
python
commands by adding the following line to your.zshrc
file:export PATH="/usr/local/opt/python/libexec/bin:$PATH"
Save and close the file. Then, source the
.zshrc
file to update your environment:source ~/.zshrc
-
Verify Python Environment: Check that the correct version of Python is being used:
python --version
This should reflect the version installed via Homebrew or
pyenv
. -
Run
run.sh
: To execute therun.sh
script, which will install required Python packages and run the GUI application:-
Ensure the script has execute permissions:
chmod +x run.sh
-
Run the script:
./run.sh
This will install necessary Python packages from
requirements.txt
and start the GUI application. -
-
Launch the Application: Run
./run.sh
from the terminal to start Hermes. -
Select Conversations: In the left panel, click on conversations to add them to the processing list.
-
Export: Click the "Export" button when your list is complete. Name the subdirectory when prompted. Exports are saved to
Documents/exported_chats
. -
Search: Use the search bar to find specific keywords or phrases within selected conversations.
-
Google Drive Export: To export to Google Drive, follow the instructions in
model/README.md
. -
Quit: Close the application window to exit Hermes.
This project is open-source and available under the MIT License.
For support or inquiries, please contact [email protected].