Skip to content

Configure the e621 UI to your liking using profiles and view configs

Notifications You must be signed in to change notification settings

S87GMIL/e621Configurator

Repository files navigation

e621 Configurator

Installation

Userscript

To install the script, you will need a user script manager like Tanpermonkey.
Once installed, simply follow this link to install.

Chromium Extension

To install a chromium extension from a local file, you will first have to download and unpack the e621Configurator-BrowserExtension.zip somewhere on your PC.
After unpacking, you will have to visit the extensions page by entering "chrome://extensions/" in the search bar (Chromium browsers will redirect you to their own extensions page) and activate the "Developmer mode", this switch is usually located in the top right corner of the extension page.
After enabling the developer mode, you should see a button called "Load unpacked", once pressed you can select the unpacked "e621Configurator-BrowserExtension" folder and press "select folder".
This should automatically add the local extension to your browser.

Overview

This user script enables you to modify the UI of e621 to your liking, with the use of profiles and view configurations.
The main configuration dialog can be accessed using the "Configure View" button on the right side of the main navigation bar.

Tutorial

Visit the Wiki for an in depth tutorial.

Profiles

A profile is used as a container for view configurations and a way to manage your different layouts, they can also be imported and exported in order to share them between devices.
By pressing "Use", the selected profile will be loaded and set as default, so every time you open the site that profile will be loaded.

Set Suggestion

Since version 2 of the script, users can enable the set suggestion feature in the profile configuration dialog.

If the checkbox is checked and the correct username has been entered, the script will automatically add a suggestion section to the "Add to set dialog":

The script will now attempt to load all of your sets and collect the posts and their tags, so it can be later matched with the currently opened post.
This loading process can sometimes take a while, and heavily depends on the amount of sets you have.
After the sets have been loaded, the suggestions will appear much fater, because the set data is cached for 30 days and doesn't have to be reloaded every time you open a post.

Thus it is suggested to activate the feature, open a post and wait until the suggestions are loaded once.

The suggestions are sorted according to their likelihood to fit the current post, if this isn't the case and the first suggested set doesn fit, you can simply display the next best suggestion by pressing "Next Suggestion".
If you want to directly add the post to the suggested set, you can press the "Add to suggested set" button, which will automatically add the current post to the suggested set. After the button press, the next suggestion will be laoded, in case you want to add the post to multiple likely sets.

View Configurations

The view configuration page can be accessed by pressing "Edit" on a profile, the view configuration table is located below the "Edit Profile" section.
In order to create a view configuration you will first have to define a relative URL path, for which the configuration should be used. If you want to configure the current path, you can simply press "User Current Path" and then "Create".
It is also possible to edit or delete view configurations on this page.

View Configuration

Basic Settings

After creating a view configuration or pressing "Edit" on an existing one, you will be led to the view configuration page.
At the top of the page you can again define the path and an option to include all sub paths.

As an example for this option we use the following path: "/posts/1802444"
If "Include subpaths" is checked, this view configuration will be used for the path above, because only the beginning, in our case "/posts", has to match.
If the subpaths are not included, the view configuration will not be used, because the URL path has to exactly match the view configuration path.

It is also possible to define specific URL parameters, that have to be matched, in order for the view configuration to become active. These parameters can either be entered manually, or by using the "Use Current Parameters" button. This is useful if you are creating a view configuration for your post sets, where the parameters have to match your ID e.g "?search[creator_id]=YourID";
It is also possible to use wildcards, in the form of "*", to only match certain parts of the URL parameters e.g. "*[creator_id]=YourID*"


Element Modification

Below the basic settings you will find the following expandable panels, which are used to configure elements on the view.

- Hidden Elements: In here you define which elements should be hidden.
- Modified Elements: Here you can select elements be their ID, XPath or class and add CSS Style parameters and classes (Examples in the S87 Tweaks Profile)
- Moved Elements: In here you can move elements to another position, e.g. move the "Add To Set" button next to the favorite button (Example in the S87 Tweaks Profile)
- Changed Links: This is used to change the destination of a link, e.g. change the link of the "My Sets" button, so it opens your sets sorted by name.
- Created Links: As the name suggests you can create your own links and buttons in this section

View Specific Settings

At the moment there are the following view specific settings, which are only available for certain views like "Posts" and "Post Sets":

Post View Specific Settings

In here you can define custom groups that will be displayed in the selection dialog when pressing "Add to set".
This can be especially helpful if you have a lot of sets and want to order and group them in some way, to make the dropdown more organized.
Sets that should be included in a group can be defined either by using wildcards in the form of "*", or by using their display name.

Final Result

Set View Specific Settings

In here you can define custom set tables, similar to the groups above, the only difference being, that they are rendered as tables in the sets view.



Examples

These are just a few simple changes performed using this tool

Cleaner image controls with a custom add to set button


Custom add to set dialog that allows the creation of new sets


Larger artist tag with custom margins so it's easier to press on tablets


Changed "Mine" link, so it opens my sets sorted by name


About

Configure the e621 UI to your liking using profiles and view configs

Resources

Stars

Watchers

Forks

Packages

No packages published