ActivityWatch / ActivityWatch/docs

Port conflict handling is not user-friendly (should fallback or guide user)

未关闭
#169 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
主要语言
Python
星标
31
派生
84
平均合并
12 天 5 小时
30 天内合并 PR
2

描述

# ActivityWatch Port Conflict Handling

## 📄 Description

When port **5600** is already in use, ActivityWatch fails to start and shows:

> Address already in use
> Port 5600 is in use by another program. Either identify and stop that program, or start the server with a different port.

This creates confusion because:

* The user cannot tell what is using the port
* No automatic fallback is attempted
* No guidance is provided

## 💡 Suggested Improvements

* Detect if port is already in use
* Either:

* Automatically select the next available port (e.g. 5601, 5602)
* **OR** clearly show:

* Which process is using the port
* How to resolve it

### Optional Enhancements

* Allow configurable default port

## 🎯 Why? very important to the end user and is a part of UX design

## ⚔️ When Does This Happen?

### ✅ Case 1: ActivityWatch already running

Most common case.

You tried to start it again → conflict occurs.

### ⚠️ Case 2: Another application using the port

Rare, but possible.

Any application can bind to any free port.

### 🔁 Case 3: Previous instance didn’t shut down properly

A leftover (zombie) process is still holding the port.

# 🙋 Contribution

I’d be interested in working on this if the approach aligns with the project direction.

贡献指南

这个仓库没有索引到贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。