git-annex-import(1)          General Commands Manual         git-annex-import(1)

       git-annex-import - move and add files from outside git working copy

       git annex import [path ...]

       Moves files from somewhere outside the git working copy, and adds them to
       the annex. Individual files to import can be specified.  If a directory
       is specified, the entire directory is imported.

        git annex import /media/camera/DCIM/*

       When importing files, there's a possibility of importing a duplicate of a
       file that is already known to git-annex -- its content is either present
       in the local repository already, or git-annex knows of another repository
       that contains it, or it was present in the annex before but has been
       removed now.

       By default, importing a duplicate of a known file will result in a new
       filename being added to the repository, so the duplicate file is present
       in the repository twice. (With all checksumming backends, including the
       default SHA256E, only one copy of the data will be stored.)

       Several options can be used to adjust handling of duplicate files.


              Do not delete files from the import location.

              This could allow importing the same files repeatedly to different
              locations in a repository. More likely, it could be used to import
              the same files to a number of different branches or separate git

              Only import files that are not duplicates; duplicate files will be
              deleted from the import location.

              Only import files that are not duplicates; and avoid deleting
              duplicate files from the import location.

              Does not import any files, but any files found in the import
              location that are duplicates are deleted.

              Allow existing files to be overwritten by newly imported files.

              Also, causes .gitignore to not take effect when adding files.

       file matching options
              Many of the git-annex-matching-options(1) can be used to specify
              files to import.

                   git annex import /dir --include='*.png'

       --jobs=N -JN
              Imports multiple files in parallel. This may be faster.  For
              example: -J4

       Note that using --deduplicate or --clean-duplicates with the WORM backend
       does not look at file content, but filename and mtime.



       Joey Hess <>