Skip to content

Commit f18e312

Browse files
authored
Update README.md
1 parent e309eeb commit f18e312

File tree

1 file changed

+27
-5
lines changed

1 file changed

+27
-5
lines changed

README.md

Lines changed: 27 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
# Booru Augmentation Project
22
A userscript that improves usability of basic *.booru.org hosted sites.
33

4-
It's no secret that free accounts on booru.org offer very little convenience compared to well-developed boorus like Danbooru.
5-
My goal is to do what is possible on client-side to compensate for the lack of functionality on the server side.
4+
It's no secret that free accounts on booru.org offer very little convenience compared to well-developed sites like Danbooru.
5+
My goal is to do what is possible on client-side to compensate for the lack of functionality of the server side.
66

77
## List of features:
88

99
* Drop-down select tag list for the search field
1010

1111
![screen](http://puu.sh/lD5FK/c90fd506d8.png)
1212

13-
Like on Danbooru, but so far only works for the first tag entered.
13+
Like on Danbooru, but so far only works for the first tag entered. The data for autocompletion is being collected as you navigate the booru, so its accuracy depends on your booru usage.
1414

1515
* AJAX tag editor
1616

@@ -30,9 +30,31 @@ Improve readability, add user links and image title, remove unnecessary info.
3030

3131
By default booru only shows 10 next links, which makes jumping several pages back impossible.
3232

33-
Aside from these, I added some minor tweaks such as fitting the post image into screen width, fixing links to user accounts, highlighting potential mistakes in tags input, showing complete tag list in account options and some other.
33+
* The scripts adds its settings section to your account options.
3434

35-
Note, that tags information such as the list of them for autocompletion and amount of posts for every tag is being collected and accumulated as your navigate the booru. Which means that it will be inaccurate right after installing of the userscript, but will get better with more usage.
35+
![screen](http://puu.sh/qAgtv/15a2dac554.png)
36+
37+
From here you can see the full list of tags the script collected so far, paired with their amount of posts (this data is used for search autocompletion). Another option is to enable the advanced booru tools:
38+
39+
* Booru scanner
40+
41+
![screen](http://puu.sh/qAgNc/3b2b832a0a.png)
42+
43+
This utility allows you to scan the entire booru or just the posts with selected tags. Scanning builds up the tag database for autocompletion and also allows you to download it in JSON format, as well as data for every post (id, rating, score, tags and image cluster) and a list of links to both image thumbnails and full-sizes. The latter can be fed to any mass-downloader to obtain a booru dump. Having both a collection of image thumbnails and a post database allows you to
44+
45+
* Search posts by images
46+
47+
![screen](http://puu.sh/qAiKm/b5d6d120fb.jpg)
48+
49+
You can find what post a saved thumbnail corresponds to by using this tool. It's useful when you're running duplicate checks on your booru and end up with a list of image doubles to delete.
50+
51+
* Remove tagme tags
52+
53+
![screen](http://puu.sh/qAiR9/811148b73e.png)
54+
55+
Made to overcome the needless "minimum of 5 tags" requirement that spams your uploads with the tagme tag, making it impossible to find posts that actually need to be tagged. Do note that this tool is only useful for admins, because it will attempt to edit any post it encounters and if you don't have right for it it'll fail and stop the progress. It is also advised to avoid editing other tags manually until the process finishes since booru limits the amount of consecutive edit queries and they're all used up by the script.
56+
57+
Aside from these, I added some minor tweaks such as fitting the post image into screen width, fixing links to user accounts, linkifying users and links in comments as well as tags in the alias list, highlighting potential mistakes in tags input, fixing incorrect handling of _ in tags and some other.
3658

3759
You feedback is required, please go to the [Issues](https://github.com/Seedmanc/Booru-Augmentation-Project/issues) section and make suggestions which features I should add, and what would you like to see.
3860

0 commit comments

Comments
 (0)