Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto
  • ¿Algo no está bien?
#169 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@TimeToBuildBob ya está trabajando en esto.

Desde el 2/10/2026.

  • #191 de @TimeToBuildBob — abierto

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Necesita aclaración
Estado de actividad
Tranquilo
Área
backend

Línea de trabajo

No se nombran archivos de implementación, pruebas ni puntos de entrada. Empieza localizando el código de inicio de ActivityWatch que enlaza el puerto 5600 y, después, aclara con los maintainers si se prefiere un fallback automático o una guía práctica para resolver el conflicto. «Done» debe incluir el comportamiento elegido, una resolución clara para el usuario y cobertura para un puerto ocupado.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
Python
Estrellas
31
Forks
84
Merge medio
10 h 33 min
PR fusionados (30 d)
5

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de ActivityWatch/docs

Todos los issues de ActivityWatch/docs

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.