Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

オープン
#169 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
説明が足りない
活発さ
静か
領域
backend

調査の方向性

実装ファイル、テスト、エントリーポイントは指定されていません。まず、ポート 5600 を bind している ActivityWatch の起動コードを見つけ、その後、automatic fallback と、競合を解決するための具体的な案内のどちらを優先するかを maintainer と確認してください。Done には、選択した動作、ユーザー向けの明確な解決方法、および使用中のポートに対するカバレッジを含める必要があります。

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語
Python
スター
31
フォーク
84
平均マージ
11時間 45分
マージ済み PR(30日)
4

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

ActivityWatch/docs のほかの issue

ActivityWatch/docs の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。