da is a command-line tool that syncs the galleries of the DeviantArt
artists you watch to a folder on your disk, and lets you search and
browse DeviantArt from the terminal.
| I want to… | Page |
|---|---|
| install it and get my first download working | Getting started |
| understand one command properly | Command guides |
| look up a command or a flag | Command reference |
| fix an error I just got | Troubleshooting |
| download new art automatically every day | Scheduling |
| change a setting | Configuration |
| find where files are written, or uninstall | Files on disk |
wrap da in a cron job or monitor it |
Scripting |
| know what an exit code means | Exit codes |
| set something via the environment | Environment variables |
| know what da-cli does with my OAuth secret | Security model |
| run the tests | Testing |
| understand why it is built this way | Decision records |
Four kinds of page, because readers arrive with four different kinds of question:
- Getting started — a tutorial. Follow it start to finish, once, and you will have art on disk. It assumes no prior command-line experience.
- Command guides (
commands/) — one page per group of commands, documenting every flag, what it writes and how it behaves on a second run. Read these when you know what you want and need the whole picture of one area: authentication, syncing, searching, inspecting, configuration, index and health. - Guides (
guides/) — how to accomplish one specific thing you already know you want: scheduling, troubleshooting, testing. - Reference (
reference/) — look-up material, complete and dry. Every command and flag is generated from the parser, so it is exhaustive but says nothing about behaviour; the command guides above are where the behaviour lives. Also: every setting, what gets written where, environment variables, exit codes, and scripting for unattended use. - Explanation (
explanation/) — background you read to understand rather than to do: the security model and the decision records.
- README — what da-cli is, and the 30-second tour
- CONTRIBUTING — the bar for a pull request
- ARCHITECTURE — a map of the package for contributors
- AGENTS.md — reference for AI coding agents driving
da - CHANGELOG — what changed in each release