git-annex/doc/assistant/quickstart.mdwn
Joey Hess 7189dfd77d git-annex (5.20131127) unstable; urgency=low
* webapp: Detect when upgrades are available, and upgrade if the user
    desires.
    (Only when git-annex is installed using the prebuilt binaries
    from git-annex upstream, not from eg Debian.)
  * assistant: Detect when the git-annex binary is modified or replaced,
    and either prompt the user to restart the program, or automatically
    restart it.
  * annex.autoupgrade configures both the above upgrade behaviors.
  * Added support for quvi 0.9. Slightly suboptimal due to limitations in its
    interface compared with the old version.
  * Bug fix: annex.version did not get set on automatic upgrade to v5 direct
    mode repo, so the upgrade was performed repeatedly, slowing commands down.
  * webapp: Fix bug that broke switching between local repositories
    that use the new guarded direct mode.
  * Android: Fix stripping of the git-annex binary.
  * Android: Make terminal app show git-annex version number.
  * Android: Re-enable XMPP support.
  * reinject: Allow to be used in direct mode.
  * Futher improvements to git repo repair. Has now been tested in tens
    of thousands of intentionally damaged repos, and successfully
    repaired them all.
  * Allow use of --unused in bare repository.

# imported from the archive
2013-11-27 18:41:44 -04:00

30 lines
1,016 B
Markdown

## first run
To get started with the git-annex assistant, just pick it from
your system's list of applications.
[[!img assistant/menu.png]]
[[!img assistant/osx-app.png]]
It'll prompt you to set up a folder:
[[!img assistant/makerepo.png]]
Then any changes you make to its folder will automatically be committed to
git, and synced to repositories on other computers. You can use the
interface to add repositories and control the git-annex assistant.
[[!img assistant/running.png]]
## starting on boot
The git-annex assistant will automatically be started when you log in to
desktop environments like Mac OS X, Gnome, XFCE, and KDE, and the menu item
shown above can be used to open the webapp. On other systems, you may need
to start it by hand.
To start the webapp, run `git annex webapp` at the command line.
To start the assistant without opening the webapp,
you can run the command "git annex assistant --autostart". This is a
good thing to configure your system to run automatically when you log in.