rewind-timeline 0.1.0__tar.gz

rewind_timeline-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DarkGlitch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rewind_timeline-0.1.0/PKG-INFO

@@ -0,0 +1,274 @@
+Metadata-Version: 2.4
+Name: rewind-timeline
+Version: 0.1.0
+Summary: Linux timeline collector and monitoring tool
+Home-page: https://github.com/LaVenganzaDelLadron/rewind.git
+Author: DarkGlitch
+Author-email: darkglitch5417@gmail.com
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Rewind
+
+**Rewind** is a Linux Time Machine that records important system events and allows users to revisit what happened on their machine.
+
+It helps answer questions such as:
+
+* What changed yesterday?
+* Why did my system become slow?
+* Which package was installed?
+* Which service stopped?
+* What commands did I run?
+* Which files were modified?
+
+Rewind stores these events locally in a SQLite database and provides a simple command-line interface for exploring the system timeline.
+
+---
+
+## Features
+
+* Package monitoring (Pacman support)
+* Service monitoring
+* Performance monitoring
+* Shell history tracking
+* File change monitoring
+* Timeline search
+* Daily activity reports
+* System statistics
+
+---
+
+## Project Structure
+
+```text
+rewind/
+├── collect.py
+├── rewind.py
+├── database.py
+│
+├── collectors/
+│   ├── files.py
+│   ├── packages.py
+│   ├── performance.py
+│   ├── services.py
+│   └── shell.py
+│
+├── commands/
+│   ├── search.py
+│   ├── stats.py
+│   ├── today.py
+│   └── yesterday.py
+│
+└── rewind.db
+```
+
+---
+
+## Requirements
+
+* Python 3.10+
+* Linux
+* systemd
+* SQLite
+
+Install dependencies:
+
+```bash
+pip install psutil watchdog
+```
+
+---
+
+## Running the Collector
+
+The collector continuously monitors the system and stores events.
+
+```bash
+python collect.py
+```
+
+The collector records:
+
+* package changes
+* service state changes
+* performance alerts
+* shell history
+* file modifications
+
+---
+
+## Commands
+
+### View today's events
+
+```bash
+python rewind.py today
+```
+
+### View yesterday's events
+
+```bash
+python rewind.py yesterday
+```
+
+### Search the timeline
+
+```bash
+python rewind.py search nginx
+```
+
+### View statistics
+
+```bash
+python rewind.py stats
+```
+
+### Show help
+
+```bash
+python rewind.py help
+```
+
+---
+
+## Example
+
+```text
+$ python rewind.py today
+
+Rewind - 2026-06-27
+
+[08:32:10] [PACKAGE] Installed nginx
+[09:15:22] [FILE] Modified /etc/ssh/sshd_config
+[11:10:33] [PERFORMANCE] CPU usage reached 95%
+[13:00:17] [SERVICE] nginx.service restarted
+[13:01:55] [SHELL] sudo systemctl restart nginx
+```
+
+---
+
+## Database
+
+Rewind stores events inside a local SQLite database.
+
+Location:
+
+```text
+~/.rewind.db
+```
+
+Schema:
+
+```sql
+CREATE TABLE events (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    timestamp TEXT NOT NULL,
+    category TEXT NOT NULL,
+    title TEXT NOT NULL,
+    details TEXT
+);
+```
+
+---
+
+## Current Collectors
+
+### Package Collector
+
+Parses:
+
+```text
+/var/log/pacman.log
+```
+
+Tracks:
+
+* installed packages
+* removed packages
+* upgraded packages
+
+---
+
+### Service Collector
+
+Uses:
+
+```text
+systemctl
+```
+
+Tracks:
+
+* started services
+* stopped services
+* restarted services
+* failed services
+
+---
+
+### Performance Collector
+
+Monitors:
+
+* CPU usage
+* memory usage
+* disk usage
+
+---
+
+### Shell Collector
+
+Reads:
+
+```text
+~/.bash_history
+```
+
+Tracks executed commands.
+
+---
+
+### File Collector
+
+Uses:
+
+```text
+watchdog
+```
+
+Tracks:
+
+* created files
+* modified files
+* deleted files
+
+---
+
+## Roadmap
+
+* systemd service support
+* daemon mode
+* multi-distribution package support
+* export reports
+* weekly summaries
+* interactive TUI
+* notifications
+* command learning mode
+* performance history graphs
+
+---
+
+## License
+
+MIT License
+
+---
+
+## Author
+
+Created by DarkGlitch.
+
+Rewind aims to become a personal timeline for Linux systems.

rewind_timeline-0.1.0/README.md

@@ -0,0 +1,261 @@
+# Rewind
+
+**Rewind** is a Linux Time Machine that records important system events and allows users to revisit what happened on their machine.
+
+It helps answer questions such as:
+
+* What changed yesterday?
+* Why did my system become slow?
+* Which package was installed?
+* Which service stopped?
+* What commands did I run?
+* Which files were modified?
+
+Rewind stores these events locally in a SQLite database and provides a simple command-line interface for exploring the system timeline.
+
+---
+
+## Features
+
+* Package monitoring (Pacman support)
+* Service monitoring
+* Performance monitoring
+* Shell history tracking
+* File change monitoring
+* Timeline search
+* Daily activity reports
+* System statistics
+
+---
+
+## Project Structure
+
+```text
+rewind/
+├── collect.py
+├── rewind.py
+├── database.py
+│
+├── collectors/
+│   ├── files.py
+│   ├── packages.py
+│   ├── performance.py
+│   ├── services.py
+│   └── shell.py
+│
+├── commands/
+│   ├── search.py
+│   ├── stats.py
+│   ├── today.py
+│   └── yesterday.py
+│
+└── rewind.db
+```
+
+---
+
+## Requirements
+
+* Python 3.10+
+* Linux
+* systemd
+* SQLite
+
+Install dependencies:
+
+```bash
+pip install psutil watchdog
+```
+
+---
+
+## Running the Collector
+
+The collector continuously monitors the system and stores events.
+
+```bash
+python collect.py
+```
+
+The collector records:
+
+* package changes
+* service state changes
+* performance alerts
+* shell history
+* file modifications
+
+---
+
+## Commands
+
+### View today's events
+
+```bash
+python rewind.py today
+```
+
+### View yesterday's events
+
+```bash
+python rewind.py yesterday
+```
+
+### Search the timeline
+
+```bash
+python rewind.py search nginx
+```
+
+### View statistics
+
+```bash
+python rewind.py stats
+```
+
+### Show help
+
+```bash
+python rewind.py help
+```
+
+---
+
+## Example
+
+```text
+$ python rewind.py today
+
+Rewind - 2026-06-27
+
+[08:32:10] [PACKAGE] Installed nginx
+[09:15:22] [FILE] Modified /etc/ssh/sshd_config
+[11:10:33] [PERFORMANCE] CPU usage reached 95%
+[13:00:17] [SERVICE] nginx.service restarted
+[13:01:55] [SHELL] sudo systemctl restart nginx
+```
+
+---
+
+## Database
+
+Rewind stores events inside a local SQLite database.
+
+Location:
+
+```text
+~/.rewind.db
+```
+
+Schema:
+
+```sql
+CREATE TABLE events (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    timestamp TEXT NOT NULL,
+    category TEXT NOT NULL,
+    title TEXT NOT NULL,
+    details TEXT
+);
+```
+
+---
+
+## Current Collectors
+
+### Package Collector
+
+Parses:
+
+```text
+/var/log/pacman.log
+```
+
+Tracks:
+
+* installed packages
+* removed packages
+* upgraded packages
+
+---
+
+### Service Collector
+
+Uses:
+
+```text
+systemctl
+```
+
+Tracks:
+
+* started services
+* stopped services
+* restarted services
+* failed services
+
+---
+
+### Performance Collector
+
+Monitors:
+
+* CPU usage
+* memory usage
+* disk usage
+
+---
+
+### Shell Collector
+
+Reads:
+
+```text
+~/.bash_history
+```
+
+Tracks executed commands.
+
+---
+
+### File Collector
+
+Uses:
+
+```text
+watchdog
+```
+
+Tracks:
+
+* created files
+* modified files
+* deleted files
+
+---
+
+## Roadmap
+
+* systemd service support
+* daemon mode
+* multi-distribution package support
+* export reports
+* weekly summaries
+* interactive TUI
+* notifications
+* command learning mode
+* performance history graphs
+
+---
+
+## License
+
+MIT License
+
+---
+
+## Author
+
+Created by DarkGlitch.
+
+Rewind aims to become a personal timeline for Linux systems.

rewind_timeline-0.1.0/collectors/collect.py

@@ -0,0 +1,52 @@
+# collect.py
+
+import time
+import sys
+from pathlib import Path
+
+sys.path.append(
+    str(Path(__file__).resolve().parent.parent)
+)
+
+from database import Database
+
+from collectors.packages import PackageCollector
+from collectors.services import ServiceCollector
+from collectors.performance import PerformanceCollector
+from collectors.shell import ShellCollector
+from collectors.files import FileCollector
+
+def start(stop_event=None):
+    db = Database()
+
+    packages = PackageCollector()
+    services = ServiceCollector()
+    performance = PerformanceCollector()
+    shell = ShellCollector()
+
+    # Start file monitoring (queue-based) in parallel with other collectors.
+    # Watching / can be noisy; change watch_root if needed.
+    file_collector = FileCollector(watch_path="/", recursive=True)
+    file_collector.start()
+
+
+    print("Rewind monitor started.")
+
+    while True:
+        if stop_event is not None and stop_event.is_set():
+            break
+
+        all_events = []
+
+        all_events.extend(packages.read_new_events())
+        all_events.extend(services.check_changes())
+        all_events.extend(performance.check())
+        all_events.extend(shell.read_new_commands())
+        all_events.extend(file_collector.read_new_events())
+
+        db.add_events(all_events)
+
+        time.sleep(10)
+
+    file_collector.stop()
+    db.close()

rewind_timeline-0.1.0/collectors/files.py

@@ -0,0 +1,104 @@
+import os
+import time
+import threading
+from pathlib import Path
+from queue import Queue, Empty
+
+from watchdog.observers import Observer
+from watchdog.events import FileSystemEventHandler
+
+
+class FileCollector(FileSystemEventHandler):
+    """Queue-based file change collector.
+
+    Produces events into an internal Queue so the main loop can batch them.
+    """
+
+    def __init__(
+        self,
+        watch_path: str | Path = "/",
+        recursive: bool = True,
+        throttle_seconds: float = 2.0,
+    ):
+        super().__init__()
+        self.watch_path = Path(watch_path)
+        self.recursive = recursive
+
+        self._queue: Queue = Queue()
+
+        # Debounce by (event_type, src_path) and only emit once per throttle window.
+        self.throttle_seconds = throttle_seconds
+        self._last_emitted = {}
+
+        self._observer: Observer | None = None
+
+    def start(self):
+        if self._observer is not None:
+            return
+
+        observer = Observer()
+        observer.schedule(self, str(self.watch_path), recursive=self.recursive)
+        observer.start()
+        self._observer = observer
+
+    def stop(self):
+        if self._observer is None:
+            return
+        self._observer.stop()
+        self._observer.join(timeout=5)
+        self._observer = None
+
+    def _enqueue(self, event_type: str, src_path: str):
+        now = time.time()
+        key = (event_type, src_path)
+        last = self._last_emitted.get(key)
+        if last is not None and (now - last) < self.throttle_seconds:
+            return
+
+        self._last_emitted[key] = now
+        title = f"{event_type}: {src_path}"
+
+        # Keep it consistent with other collectors.
+        self._queue.put({
+            "category": "file",
+            "title": title,
+        })
+
+    def on_modified(self, event):
+        if event.is_directory:
+            return
+        self._enqueue("Modified", event.src_path)
+
+    def on_created(self, event):
+        if event.is_directory:
+            return
+        self._enqueue("Created", event.src_path)
+
+    def on_deleted(self, event):
+        if event.is_directory:
+            return
+        self._enqueue("Deleted", event.src_path)
+
+    def read_new_events(self, max_events: int = 500):
+        events = []
+        for _ in range(max_events):
+            try:
+                events.append(self._queue.get_nowait())
+            except Empty:
+                break
+        return events
+
+
+# Backwards-compatible function kept for older imports.
+# This project primarily uses FileCollector.
+
+def monitor(path: str | Path):
+    collector = FileCollector(watch_path=path)
+    collector.start()
+
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        collector.stop()
+