Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta
#169 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Tranquilla
Ambito
backend

Direzione di ricerca

Non vengono indicati file di implementazione, test o punti di ingresso. Inizia individuando il codice di avvio di ActivityWatch che esegue il bind sulla porta 5600, quindi chiarisci con i maintainer se sia preferibile un fallback automatico o indicazioni concrete per risolvere il conflitto. «Done» dovrebbe includere il comportamento scelto, una risoluzione chiara per l’utente e la copertura del caso di una porta occupata.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
Python
Stelle
31
Fork
84
Merge medio
11h 45m
PR unite (30g)
4

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di ActivityWatch/docs

Tutte le issue di ActivityWatch/docs

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.