<p>So, we have stored some media in our database. Everything is hashed and cached. We can search by inbox and resolution and size and so on, but if we really want to find what we are looking for, we shall have to use <i>tags</i>.</p>
<p><ahref="faq.html#tags">FAQ: hold up, what is a tag?</a></p>
<pclass="warning">The client starts with a 'local tags' service, which stores tags only on your client's database, where only you can see them. This is useful, and you should keep it in mind for specific jobs as you read the rest of this page, but please do not try to tag everything you own by yourself; unless you have a tiny collection, it will take you hundreds of hours, and your time is better spent helping build tag collections with other people.</p>
<p>In order to share tags with others, you must connect to at least one tag repository. You can create your own, if you like, and share access with whoever you like. I run a public tag repository, which you are very welcome to access and contribute to. To add its details, go <i>services->add, remove or edit services</i>, select 'tags' on the left, and hit the 'add' button. You'll be asked if you have a registration key or an access key; you have an access key.</p>
<p><b>Tags are rich, cpu-intensive metadata. My repository has millions of mappings (about 70MB of network data, at last count), so expect your computer to take <i>hours</i> to synchronise fully. You can close the client at any time, and it will continue where it left off when it next boots. If it is slowing your normal browsing, you can pause it at <i>services->pause->repositories synchronisation</i>.</b></p>
<p>The client will report its current update processing status in the middle of the status bar, at the bottom of the screen. You can watch more detailed progress in the <i>services->review services</i> dialog as usual.</p>
<p><imgsrc="tag_repo_review.png"/></p>
<h3>adding tags</h3>
<p>If you connect to a repository that has a lot of tags, you'll probably see them appearing in your client in any normal search. But if you want tags for your rarer files, or you don't connect to any big repositories, you'll have to add some tags yourself.</p>
<p>Select some files. Right click on them and select <i>manage->tags</i>, or hit F3. This will boot the very important <i>manage tags dialog</i>.</p>
<p>This shows the <b>intersection</b> of the current selection's tags (it only shows the tags that <i>every</i> file in the selection has), and will equally add/remove tags to/from the entire selection. There's another autocomplete dropdown, just like when you search, that throws what you input at the box above. Submitting a tag that already exists will attempt to remove it, or you can just double click it. You may be prompted to give a reason for removing a tag from a remote repository, creating a petition that an administrator will review.</p>
<p>The tag box will prepend certain identifiers to show the changes that'll occur or pend when you hit <i>apply</i>:</p>
<ulclass="bulletpoints">
<li><b>Nothing</b> - Existing tag.</li>
<li><b>(+)</b> - Will be applied/pended.</li>
<li><b>(-)</b> - Will be removed/petitioned.</li>
<li><b>(X)</b> - Has already been applied and deleted; you may or may not have authority to re-apply.</li>
</ul>
<p>If you edit tags for the local tags service, they will be applied instantly; otherwise, they will be pended, waiting until you are ready to upload. When you are ready to upload all your pending tag changes, use the <i>pending</i> menu in the main interface.</p>
<p>Please do not upload 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 only interested in objective tags. If you don't like my guidelines, feel free to start your own tag repo!</p>
<p>You can synchronise with more than one tag repository. Press the up or down arrow keys on an empty autocomplete input to quickly jump between your repositories. Each repo's beliefs about which tags go with which files will be applied according to a certain precedence that you can edit in <i>services->manage tag service precedence</i>.</p>
<p><ahref="faq.html#delays">FAQ: why can my friend not see what I just uploaded?</a></p>