See the v0.10.2 release notes for changes, upgrading, and compatibility notes.
Download the .msi installer from the release page.
💡 If Windows Defender SmartScreen says "it prevented an unrecognized app from starting" after downloading, you'll need to click "Run anyway".
Download the .pkg installer from the release page;
Or use Homebrew to install: brew cask install koordinates/kart/kart
For Debian/Ubuntu-based distributions, download the .deb package from the release page and install via dpkg -i kart_*.deb
.
For RPM-based distributions, download the .rpm package from the release page and install via rpm -i kart-*.rpm
.
For Kart development see the Contributing Notes.
See the documentation for tutorials and reference.
Configure the identity you will use for Kart commits with:
$ kart config --global user.email "you@example.com" $ kart config --global user.name "Your Name"
- Export a GeoPackage from Koordinates with any combination of vector layers and tables.
- Create a new Kart repository and import the GeoPackage (eg.
kx-foo-layer.gpkg
).Use this repository as the directory to run all the other commands in. This will also create a working copy as$ kart init myproject --import GPKG:kx-foo-layer.gpkg $ cd myproject
myproject/myproject.gpkg
to edit. - Editing the working copy in QGIS/etc:
- will track changes in the internal
kart
tables - additions/edits/deletes of features are supported
- changing feature PKs is supported
- schema changes should be detected, but aren't supported yet (will error).
- Use F5 to refresh your QGIS map after changing the underlying working-copy data using
kart
.
- will track changes in the internal
- With your working copy,
kart
commands should work if run from themyproject/
folder. Check--help
for options, the most important ones are supported. In some cases options are passed straight through to an underlying git command:kart diff
diff the working copy against the repository (no index!)kart commit -m {message}
commit outstanding changes from the working copykart log
review commit historykart branch
&kart checkout -b
branch managementkart fetch
fetch upstream changes.kart status
show working copy state.kart merge
merge. Supports--ff
/--no-ff
/--ff-only
from one merge source.kart switch
switch to existing or new branches.kart reset
&kart restore
discard changes in the working copy.kart tag ...
kart remote ...
. Remember simple remotes can just be another local directory.kart push
/kart pull
kart clone
initialise a new repository from a remote URL,
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.
In addition to the permissions in the GNU General Public License, the authors give you unlimited permission to link the compiled version of this file into combinations with other programs, and to distribute those combinations without any restriction coming from the use of this file. (The General Public License restrictions do apply in other respects; for example, they cover modification of the file, and distribution when not linked into a combined executable.)
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; see the file COPYING
. If not, write to
the Free Software Foundation, 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.