📜 ChromeChronicle

   ___ _                             ___ _                      _      _      
  / __\ |__  _ __ ___  _ __ ___     / __\ |__  _ __ ___  _ __ (_) ___| | ___ 
 / /  | '_ \| '__/ _ \| '_ ` _ \   / /  | '_ \| '__/ _ \| '_ \| |/ __| |/ _ \
/ /___| | | | | | (_) | | | | | | / /___| | | | | | (_) | | | | | (__| |  __/
\____/|_| |_|_|  \___/|_| |_| |_| \____/|_| |_|_|  \___/|_| |_|_|\___|_|\___|
                                                                              

                        .__.__.__.__.__.__.__.__.__.
                       /                           /|
                      /__________________________/ |
                      |  ___________________     | |
                      | |                   |    | |
                      | |  📜 ChromeChronicle   | |
                      | |                   |    | |
                      | |  Your browsing    |    | |
                      | |  history,         |    | |
                      | |  beautifully      |    | |
                      | |  chronicled.      |    | |
                      | |___________________|    | |
                      |_________________________|/ 

Your browsing history, beautifully chronicled.

🌟 Overview

ChromeChronicle automatically extracts your daily Chrome browsing history and saves it as beautifully formatted markdown files, organized by month. Keep track of your digital journeys with minimal effort!

✨ Key Features

• 🔄 Daily Automation: Set it once, and forget it! Runs daily at your specified time
• 📊 Beautiful Markdown Format: Your history presented in an easy-to-read table format
• 📂 Organized by Month: Automatically creates and organizes files into year-month directories
• 📱 Lightweight: Minimal system impact, runs in the background
• 🔒 Local Storage: Your data stays on your machine, ensuring privacy

📋 Requirements

• macOS (10.15 Catalina or newer)
• Python 3.6+
• Google Chrome browser
• Basic Terminal knowledge

🚀 Installation

Option 1: Quick Install (Recommended)

1. Clone this repository:

   git clone https://github.com/helloprkr/chrome-chronicle.git
   cd chrome-chronicle

2. Run the installation script:

   chmod +x install_chrome_history_automation.sh
   ./install_chrome_history_automation.sh

3. You're all set! ChromeChronicle will run daily at 11:45 PM by default.

Option 2: Manual Installation

Click to expand manual installation steps

1. Clone this repository:

   git clone https://github.com/helloprkr/chrome-chronicle.git
   cd chrome-chronicle

2. Make the Python script executable:

   chmod +x chrome_history_extractor.py

3. Edit the plist file to update paths:

   nano com.user.chromehistory.plist

   Replace all instances of REPLACE_WITH_FULL_PATH with the full path to your ChromeChronicle directory.

4. Copy the plist file to your LaunchAgents directory:

   mkdir -p ~/Library/LaunchAgents
   cp com.user.chromehistory.plist ~/Library/LaunchAgents/

5. Load the launchd job:

   launchctl load ~/Library/LaunchAgents/com.user.chromehistory.plist

🖥️ Usage

ChromeChronicle will automatically run every day at the scheduled time (default: 11:45 PM). Your browsing history will be saved in markdown format in the directory structure:

YYYY-MM/YYYY-MM-DD_URL-History.md

For example:

2025-03/2025-03-07_URL-History.md

📝 Manual Execution

You can run ChromeChronicle manually at any time:

python3 /path/to/chrome-chronicle/chrome_history_extractor.py

🛠️ Customization

Changing the Schedule

To change when ChromeChronicle runs:

1. Unload the current configuration:

   launchctl unload ~/Library/LaunchAgents/com.user.chromehistory.plist

2. Edit the plist file:

   nano ~/Library/LaunchAgents/com.user.chromehistory.plist

3. Update the Hour and Minute values under StartCalendarInterval.

4. Reload the configuration:

   launchctl load ~/Library/LaunchAgents/com.user.chromehistory.plist

Output Format Customization

To customize the Markdown output format, edit the extract_chrome_history() function in chrome_history_extractor.py.

🔍 Troubleshooting

No history is being saved

Check the following:

• Ensure Chrome is installed in the default location
• Verify your LaunchAgent is loaded properly:

  launchctl list | grep chromehistory

• Check log files for errors:

  cat ~/path/to/chrome-chronicle/chrome_history_error.log

Installation script fails

• Make sure you have the proper permissions
• Try running the manual installation steps
• Check if Python 3 is installed correctly:

  python3 --version

🧩 Technical Details

How It Works

ChromeChronicle works by:

1. Creating a temporary copy of Chrome's SQLite history database
2. Querying for URLs visited on the current day
3. Converting Chrome's timestamp format (microseconds since Jan 1, 1601)
4. Formatting the data into a readable markdown table
5. Organizing files by year and month

📚 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

💖 Acknowledgments

• Inspired by the need to better understand our digital journeys
• Thanks to the SQLite project for making database access so straightforward
• Special thanks to all Alxmnt Ai Labs Team for their support and guidance!

---

Made with ❤️ by HelloPrkr

If you find ChromeChronicle useful, please consider giving it a ⭐ on GitHub and sharing it with friends!