---
name: "projsync"
section: "1"
platform: "linux"
package: "proj"
version: "9.9.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/projsync"
---

# projsync(1)

Downloading tool of resource files

## NAME

projsync - Downloading tool of resource files

## SYNOPSIS

```
projsync
[--endpoint URL]
[--local-geojson-file FILENAME]
([--user-writable-directory] | [--system-directory] | [--target-dir DIRNAME])
[--bbox west_long,south_lat,east_long,north_lat]
[--spatial-test contains|intersects]
[--source-id ID] [--area-of-use NAME]
[--file NAME]
[--all] [--exclude-world-coverage]
[--quiet | --verbose] [--dry-run] [--list-files]
[--no-version-filtering]
```

## DESCRIPTION

*projsync* is a program that downloads remote resource files into a local directory. This is an alternative to downloading a proj-data-X.Y.Z archive file, or using the on-demand *networking capabilities* of PROJ.

The following control parameters can appear in any order:

- **--endpoint URL**

  Defines the URL where to download the master **files.geojson** file and then the resource files. Defaults to the value set in *proj.ini*

- **--local-geojson-file FILENAME**

  Defines the filename for the master GeoJSON files that references resources. Defaults to **${endpoint}/files.geojson**

- **--user-writable-directory**

  Specifies that resource files must be downloaded in the *user writable directory*. This is the default.

- **--system-directory**

  Specifies that resource files must be downloaded in the ${installation\_prefix}/share/proj directory. The user launching projsync should make sure it has writing rights in that directory.

- **--target-dir DIRNAME**

  Directory into which resource files must be downloaded.

- **--bbox west\_long,south\_lat,east\_long,north\_lat**

  Specify an area of interest to restrict the resources to download. The area of interest is specified as a bounding box with geographic coordinates, expressed in degrees in a unspecified geographic CRS. *west\_long* and *east\_long* should be in the \[-180,180\] range, and *south\_lat* and *north\_lat* in the \[-90,90\]. *west\_long* is generally lower than *east\_long*, except in the case where the area of interest crosses the antimeridian.

- **--spatial-test contains\|intersects**

  Specify how the extent of the resource files are compared to the area of use specified explicitly with *--bbox*. By default, any resource files whose extent intersects the value specified by *--bbox* will be selected. If using the **contains** strategy, only resource files whose extent is contained in the value specified by *--bbox* will be selected.

- **--source-id ID**

  Restrict resource files to be downloaded to those whose source\_id property contains the ID value. Specifying **?** as ID will list all possible values.

- **--area-of-use NAME**

  Restrict resource files to be downloaded to those whose area\_of\_use property contains the NAME value. Specifying **?** as NAME will list all possible values.

- **--file NAME**

  Restrict resource files to be downloaded to those whose name property contains the NAME value. Specifying **?** as NAME will list all possible values.

- **--all**

  Ask to download all files.

- **--exclude-world-coverage**

  Exclude files which have world coverage.

- **-q / --quiet**

  Quiet mode

- **--verbose**

  Added in version 8.1.

  Verbose mode (more than default)

- **--dry-run**

  Simulate the behavior of the tool without downloading resource files.

- **--list-files**

  List file names, with the source\_id and area\_of\_use properties.

- **--no-version-filtering**

  Added in version 8.1.

  By default, projsync only downloads files that are compatible of the PROJ\_DATA.VERSION metadata of **proj.db**, taking into account the **version\_added** and **version\_removed** properties of entries in **files.geojson**. When specifying this switch, all files referenced in **files.geojson** will be candidate (combined with other filters).

At least one of  *--list-files*,  *--file*,  *--source-id*, *--area-of-use*,  *--bbox* or  *--all* must be specified.

Options *--file*,  *--source-id*, *--area-of-use* and *--bbox* are combined with a AND logic.

## EXAMPLES

- 1\.

  Download all resource files

```
projsync --all
```

- 2\.

  Download resource files covering specified point and attributed to an agency

```
projsync --source-id fr_ign --bbox 2,49,2,49
```

## SEE ALSO

**[cs2cs(1)](/cs2cs/1.md)**, **[cct(1)](/cct/1.md)**, **[geod(1)](/geod/1.md)**, **[gie(1)](/gie/1.md)**, **[proj(1)](/proj/1.md)**, **[projinfo(1)](/projinfo/1.md)**

## BUGS

A list of known bugs can be found at *https://github.com/OSGeo/PROJ/issues* where new bug reports can be submitted to. Bugs specific to resource files should be submitted to *https://github.com/OSGeo/PROJ-data/issues*

## HOME PAGE

*https://proj.org/*

## AUTHOR

Even Rouault

## COPYRIGHT

1983-2026, PROJ contributors