aw-sync-suite

KO | EN

gitlite — search

#javascript #python #react #ai #typescript #llm #android #machine-learning #deep-learning #docker #nodejs #java #vue #mcp

(★ 39)

Sync multiple ActivityWatch instances to Prometheus, centralized and visualized with Grafana.

aw-sync-suite Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Aw-Sync-Suite</h1>

Open-Source Solution for Securely Syncing and Visualizing Multiple ActivityWatch Instances.

If you’ve ever wished for a simple, centralized solution to sync and visualize data from multiple instances of ActivityWatch, you’re in the right place.
 
 📖 For detailed documentation, visit our <a href="https://github.com/phrp720/aw-sync-suite/wiki">GitHub Wiki</a>.

<summary>📑 Table of Contents</summary>

1. [About](#-about)
2. [Features](#-features)
3. [Installation & Usage](#-installation--usage)
4. [Components](#-components)
    - [aw-sync-agent](#-aw-sync-agent)
    - [aw-sync-suite-plugins](#-aw-sync-suite-plugins)
    - [aw-sync-center](#-aw-sync-center)
5. [Architecture](#-architecture)
6. [Requirements](#-requirements)
7. [Contributing](#-contributing)
8. [License](#-license)

</details>

## 🔍 About
**Aw-Sync-Suite** provides an easy-to-deploy solution on syncing data from multiple [ActivityWatch](https://github.com/ActivityWatch/activitywatch) instances to a centralized [Prometheus](https://prometheus.io/) database with easy visualization in [Grafana](https://grafana.com/).

The project operates independently of **ActivityWatch** and supports all ActivityWatch versions with a REST API.

### 👁️ Preview

| ![TOP](https://raw.githubusercontent.com/phrp720/aw-sync-suite/master/aw-sync-center/grafana/dashboards/screenshots/summary/summary_1.png) | ![BOTTOM](https://raw.githubusercontent.com/phrp720/aw-sync-suite/master/aw-sync-center/grafana/dashboards/screenshots/summary/summary_2.png) |
|-----------------------------------------------------------------------------|--------------------------------------------------------------------------------|

You can check also the [screenshots](https://github.com/phrp720/aw-sync-suite/tree/master/aw-sync-center/grafana/dashboards/screenshots) for more insights.

## 🌟 Features
- 🌐 **Centralized Monitoring:** Aggregate data from multiple devices effortlessly.
- 🛡️ **Data Filtering:** Protect sensitive information by filtering or sanitizing it at the source.
- 📍 **Checkpointing Mechanism:** Smart synchronization with automatic tracking of synced data.
- 🔌 **Plugin Mechanism:** Use the pre-built plugins or create your own for custom data processing.
-  📈 **Pre-Built Dashboards:** Use intuitive Grafana dashboards for instant insights.
- ⚙️ **Effortless Deployment:** Simple setup for both agent and central components.

## 🚀 Installation & Usage

Downloads are available on the [releases page](https://github.com/phrp720/aw-sync-suite/releases).

For instructions on how to get started, please see the [guide in the documentation](https://github.com/phrp720/aw-sync-suite/wiki/Installation-Guide).

## 🧩 Components

### 📦 [aw-sync-agent](https://github.com/phrp720/aw-sync-suite/tree/master/aw-sync-agent)

Runs on each device, retrieves and filters ActivityWatch data, and sends it securely to Prometheus via remote-write.

- **Purpose**: Syncs data from ActivityWatch to Prometheus.
- **Deployment**: Run on each computer you wish to track user activity from.
- **Configuration**: Configurable via the `aw-sync-settings.yaml` file and its [plugins](https://github.com/phrp720/aw-sync-suite-plugins).

| Platform Support | Runs as a Service (`-service`) | General Workability |
|------------------|--------------------------------|---------------------|
| **Windows**      | ✅                              | ✅                   |
| **Linux**        | ✅                              | ✅                   |
| **macOS**        | ❌                              | ✅                   |

> [!Note]
> - The **aw-sync-agent** is fully operational on **macOS**, but the `-service` feature (which allows the agent to run as a background service) is not yet implemented for macOS.
> - On macOS, you can still manually start and run the agent to sync ActivityWatch data without issues.

### 🔌 [aw-sync-suite-plugins](https://github.com/phrp720/aw-sync-suite-plugins)

The `aw-sync-suite` supports a range of plugins that allow for custom data processing before pushing the data to Prometheus. You can utilize these plugins to enhance your data synchronization capabilities.

- **Purpose**: Plugins enable pre-processing of ActivityWatch data, allowing for filtering, transformation, and custom handling based on specific requirements(read more on how they work [here](https://github.com/phrp720/aw-sync-suite/wiki/Agent-Plugins)).
- **Integration**: Easily configurable within the `aw-sync-agent` through the `aw-sync-settings.yaml` file and their configuration files.
- **Repository**: For a list of available plugins and their usage, visit the [aw-sync-suite-plugins repository](https://github.com/phrp720/aw-sync-suite-plugins).

#### How to Use Plugins

1. **Add the Plugin**: Ensure the desired plugin is available in the `aw-sync-suite-plugins` repository and modify the `aw-sync-settings.yaml` file to include the plugin.
2. **Configure the Plugin**: If the plugin is configurable add the plugin configuration in the `config` folder to configure the plugin settings.
3. **Run the Agent**: Start the `aw-sync-agent`, and it will automatically utilize the configured plugins for data processing.

### 📦 [aw-sync-center](https://github.com/phrp720/aw-sync-suite/tree/master/aw-sync-center)

A centralized Prometheus and Grafana setup for aggregating and visualizing data.

- **Purpose**: Centralized cloud setup that includes Prometheus and Grafana for monitoring and visualization.
- **Deployment**: Set up once for centralized control and management.
- **Included Services**: Prometheus, Grafana, and necessary dashboards.
 
## 📊 Architecture

Sync-Suite contains two available setups: one **without Bearer Token Authentication** and another **with Bearer Token Authentication**.

The latter provides an additional layer of security by securing the Prometheus endpoints with a Bearer token if it is exposed to the internet.
This setup uses a Nginx reverse proxy to secure the Prometheus endpoints.

| Without Bearer Token Authentication 🔓      | With Bearer Token Authentication 🔐                     |
|---------------------------------------------|---------------------------------------------------------|
| ![aw-sync-diagram.png](https://raw.githubusercontent.com/phrp720/aw-sync-suite/master/aw-sync-diagram.png) | ![aw-sync-diagram-nginx.png](https://raw.githubusercontent.com/phrp720/aw-sync-suite/master/aw-sync-diagram-nginx.png) |

## 🛠️ Requirements

- Docker and Docker Compose for easy setup of `aw-sync-center`.
- A running instance of ActivityWatch on the computers you want to monitor.

## 👥 Contributing
Contributions are welcomed! If you have ideas, improvements, or bug fixes, feel free to open an issue or submit a pull request.

## 📝 License

This project is licensed under the **MIT license**.

See [LICENSE](https://github.com/phrp720/aw-sync-suite/blob/master/LICENSE) for more information.

aw-sync-suite

aw-sync-suite Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

aw-sync-suite

aw-sync-suite Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README