NAME

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

SYNOPSIS

       git annex import [path ...]

DESCRIPTION

       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.

OPTIONS

       --duplicate

              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 repositories.

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

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

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

       --force
              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

CAVEATS

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

SEE ALSO

       git-annex(1)

       git-annex-add(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                              git-annex-import(1)