# PrintDot-Client

**Repository Path**: theGreatOldFive/PrintDot-Client

## Basic Information

- **Project Name**: PrintDot-Client
- **Description**: PrintDot Client 是一款基于 Wails 与 Vue 的桌面打印助手，主打“稳定、快速、好上手”。它将设备发现、连接管理与转发能力打包到一个轻量客户端里，让你用更少的配置成本，获得更高的打印链路稳定性与可用性。本项目是 Vue Print Designer (https://gitee.com/theGreatOldFive/vue-print-designer) 的配套客户端。
- **Primary Language**: Go
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 6
- **Created**: 2026-02-02
- **Last Updated**: 2026-03-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 打印客户端, vue-print-designer, web打印, 打印桥接器

## README

<div align="center">

# PrintDot Client

[中文](README.md) | **English**

<img src="build/appicon.png" alt="PrintDot Client Logo" width="96" />

</div>

## Introduction

PrintDot Client is a desktop printing assistant built with Wails and Vue, focusing on "stability, speed, and ease of use". It packages device discovery, connection management, and forwarding capabilities into a lightweight client, allowing you to achieve higher printing stability and availability with less configuration effort. This project is the companion client for [Vue Print Designer](https://github.com/0ldFive/Vue-Print-Designer).

## Screenshots

<table>
  <tr>
    <td align="center">
      <img src="docs/images/1.png" width="300" alt="Main Interface" /><br />
      <em>Main Interface - Device Status & Connection Management</em>
    </td>
    <td align="center">
      <img src="docs/images/2.png" width="300" alt="Settings Page" /><br />
      <em>Settings Page - Preferences & Configuration</em>
    </td>
  </tr>
</table>

## Advantages

- Instant startup and response, virtually zero wait for daily operations
- Stable and reliable discovery and forwarding, worry-free for long-term running
- Consistent cross-platform experience, less hassle from environment differences
- Lightweight architecture with low resource usage, runs smoothly even on older machines
- Polished settings and multilingual experience, easier for beginners
- Modern interface with clear information hierarchy, key status visible at a glance

## Supported Platforms

- Windows
- macOS
- Linux

## Features

- Auto-discovery and identification of local/network devices
- Stable connection maintenance and forwarding queue
- Clean visual status and alert notifications
- Multilingual interface and basic preferences
- Lightweight mode suitable for long-term background running

## Architecture & Modules

- Frontend: Vue 3 + Vite + Tailwind for UI and interactions
- Desktop Container: Wails for cross-platform windowing and system capabilities
- Backend: Go service layer for discovery, connection, forwarding, and configuration

## Installation & Usage

### Development Mode

1. Install Wails and Node.js dependencies
2. Run the development command

```bash
wails dev
```

### Production Build

```bash
wails build
```

#### Windows

```bash
wails build -clean -nsis
```

#### macOS

```bash
wails build -clean -platform darwin/amd64
wails build -clean -platform darwin/arm64
```

#### Linux

```bash
wails build -clean -platform linux/amd64
```

## Configuration

- Configuration files are automatically generated and maintained by the application
- Device and forwarding options can be adjusted in the settings page
- Changes take effect immediately without restart

## FAQ

**Q: What if the device doesn't appear or the connection is unstable?**

- Check if devices are on the same network and firewall is properly configured
- Restart the client and rediscover
- If issues persist, refer to the user manual for troubleshooting

**Q: Does it support running in background?**

- Yes, the application is optimized for low resource usage and continuous forwarding

## Contributing

- Issues and Pull Requests are welcome
- Please read the user manual and configuration guide first to maintain consistent behavior and experience

## User Manual

- 中文: [docs/usage_guide_zh.md](docs/usage_guide_zh.md)
- English: [docs/usage_guide_en.md](docs/usage_guide_en.md)