MerginMaps / MerginMaps/python-api-client

Enable download of project with a filter to include/exclude certain files or filetype

Open
#233 4 comments 3 reactions 1 assignee View on GitHub

@varmar05 is already working on this.

Since Aug 10, 2026.

enhancement testing OK
Dominant language
Python
Stars
23
Forks
12
Avg merge
2d 13h
Merged PRs (30d)
7

Description

In many cases we need to download a previous version of a project but only need the project files. In these cases, it would be useful to be able to add a filter to the project download, for example to exclude all media files, so we aren't downloading several GBs of data when we only need the project and config files.

Examples:
mergin download ws/projectname --exclude=media/* --exclude=mybgnd.mbtiles
mergin download ws/projectname --include=data/* --include=*.gpkg --include=project.qgz

No mixing between includes and excludes.

Contributor guide

Open the contributing guide

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.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.