syncthing / syncthing/docs

Add syncthing-dir-time-fixer to community tools

Open
#963 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
327
Forks
653
PR merge metrics
No merged PRs in 30d

Description

Tool Description

syncthing-dir-time-fixer - Automatically fixes directory modification times after Syncthing sync to show actual content modification times instead of sync times.

Repository: https://github.com/halapenyoharry/syncthing-dir-time-fixer

Features

  • Monitors Syncthing Event API for sync completion
  • Updates directory mtimes to match their newest file
  • Cross-platform (Linux, macOS, Windows with WSL)
  • Runs as system service (systemd/launchd)
  • Memory-efficient with leak prevention
  • Configurable delays and exclusions

Why It's Useful

While Syncthing deliberately doesn't sync directory timestamps (see syncthing/syncthing#3667), many users want to see when work was actually done, not when it was synced. This tool fills that gap without modifying Syncthing itself.

Event API Usage Example

This tool demonstrates proper Event API usage:

  • Long polling for events
  • Handling FolderCompletion events
  • Memory management for long-running processes
  • Proper session cleanup

Documentation

Could be added to:

  • Community Contributions page
  • Event API examples
  • Third-party tools section

The tool respects Syncthing's design decisions while providing an optional enhancement for users who need it.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the Community Contributions, Event API examples, and third-party tools sections of the documentation, then review the syncthing-dir-time-fixer repository linked in the issue. Done means the tool is added to the appropriate documentation section with its repository link, description, and relevant Event API details.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.