<p>So, you have stored some media in your database. Everything is hashed and cached. You can search by inbox and resolution and size and so on, but if you really want to find what we are looking for, you will have to use <i>tags</i>.</p>
<p><ahref="faq.html#tags">FAQ: what is a tag?</a></p>
<p>Your client starts with a 'local tags' service, which keeps all of its file->tag mappings in your client's database where only you can see them. It is a good place to practise. So, select a file and press F3:</p>
<p>The autocomplete dropdown in the manage tags dialog works very like the one in a normal search page<67>you type part of a tag, and matching results will appear below. You select the tag you want with the arrow keys and hit enter. Since your local tags service doesn't have any tags in it yet, you won't get any results here except the exact match of what you typed. If you want to remove a tag, enter the exact same thing again or double-click it in the box above.</p>
<p>Prefixing a tag with a category and a colon will create a <i>namespaced</i> tag. This helps inform the software and other users about what the tag is. Examples of namespaced tags are:</p>
<ul>
<li>character:batman</li>
<li>series:street fighter</li>
<li>person:jennifer lawrence</li>
<li>title:vitruvian man</li>
</ul>
<p>The client is set up to draw common namespaces in different colours, just like boorus do. You can change these colours in the options.</p>
<p>In several places around the hydrus client, always in the context of importing files from another location, you will see a <i>tag import options</i> button:</p>
<p><imgsrc="import_tag_options.png"/></p>
<p>The namespaces listed are those that hydrus knows how to parse from where you are downloading from. Selecting one will tell hydrus to get those tags and set/pend them to the respective tag service.</p>
<p>'Explicit tags' are a way to force-add some additional tags for every file that comes through this import context. This can be useful, sometimes, to create personal 'processing' tags on your local tags like 'from tumblr' or 'imported on sunday' that you can revisit to find this download's files again.</p>
<p>You can quickly get thousands of tags in a few minutes this way!</p>
<p>It can take a long time to tag even this small number of files well, so I created <i>tag repositories</i> so people can share the work.</p>
<p>Tag repos store many file->tag relationships. Anyone who has an access key to the repository can sync with it and hence download all these relationships. If any of their own files match up, they will get those tags. Access keys will also usually have permission to upload new tags and ask for existing ones to be deleted.</p>
<p>Anyone can run a tag repository, but it is a bit complicated for new users. I run a public tag repository that you are very welcome to access and contribute to. To connect with it, go <i>services->manage services->remote->tag repositories</i> and hit the 'add' button. You'll be asked if you have a <i>registration key</i> or an <i>access key</i>; you have an access key.</p>
<p>Over time, usually when it is idle, your client will download updates from the repository until it is fully synchronised. You can customise when this happens in <i>file->options->maintenance and processing</i>. As the repository synchronises, you should see some new tags appear, particularly on famous files that lots of people have.</p>
<p><b>Tags are rich, cpu-intensive metadata. My repository has millions of mappings, and your client will download and store them all. It will take a few hundred MB and several <i>hours</i> total processing time to fully synchronise. It will mostly happen in the background, without you noticing.</b></p>
<p>Your new service should now be listed on the left of the manage tags dialog. Adding tags to a repository works very similarly to the local tags service except hitting 'apply' will not immediately confirm your changes<65>it will put them in a queue to be uploaded. These 'pending' tags will be counted with a plus '+' or minus '-' sign:</p>
<p>Notice that a 'pending' menu has appeared on the main window. This lets you start the upload when you are ready and happy with everything that you have queued.</p>
<p>When you upload your pending tags, they will commit and look to you like any other tag. The tag repository will anonymously bundle them into the next update, which everyone else will download in a day or so. They will see your tags just like you saw theirs.</p>
<p>If you attempt to remove a tag that has been uploaded, you may be prompted to give a reason, creating a petition that an administrator will review.</p>
<p>Please do not spam tags to my public tag repo until you get a rough feel for the <ahref="tagging_schema.html">tag schema</a>, or just lurk until you get the idea. I am not very strict about it (it is not difficult to correct mistakes), but I essentially only want factual tags<67>no subjective opinion.</p>
<p>You can connect to many different tag repositories, if you like. When you are in the <i>manage tags</i> dialog, pressing the up or down arrow keys on an empty input switches between your services.</p>
