Getting started 1

This manual is documenting the script SuperdAmn by electricnet. If you do not know what that is, click the thumbnail to the left to find out and to download the newest version.

SuperdAmn is a userscript for Greasemonkey, an extension for Mozilla Firefox. Thus you need to have both installed. When that is done, and you’ve restarted the browser at least once, you can click the link in the artist’s comments of the deviation and it should bring up an install window.

Out of the box, when you download and install SuperdAmn for the first time, there is a range of features that are already set up for you. This is timestamps, formatting buttons and more. But when you really want to see what you can do with SuperdAmn, there’s no better way than to open the Preferences panel, and that’s why you’ll now start reading the next section.

The Preferences panel 2

The SuperdAmn Preferences panel is the heart of one of the more important parts of SuperdAmn: Customization. You can customize many parts of SuperdAmn to your liking, but first, you have to know where to access the Preferences panel where such a customization takes place.

To access the Preferences panel, you click the Preferences icon found in the top right as shown. It looks like a wrench. Click it and you get to the Preferences panel, which looks like the below:

The panel is separated in different sections by functionality. There are some special form elements that are styled to look like lines from a dAmn chatroom. When they are bright, they are editable. Everything after the username is editable; that is the only thing that is constant.

You’ll probably notice that the emote functionality is purposely not enabled by default. If you want it enabled, simply check “Enable custom emotes” and save.

In the sections for the away and ignore systems, you can edit messages. Both of these sections use various variables that you can insert in these messages. They are both prefixed and suffixed with a %-sign. Originally there could be only one instance of each type in any message, but that limit was removed in a later version.

In the away messages, you can use the following variables: %REASON% displays the reason you’re away, %TIMESINCE% displays how long you’ve been away, and %AWAYTIME% displays a string of the absolute time (in your own time zone) that you went away.

In the ignore messages and the away notification message, you use the variable %USER%. In the ignore messages, it’s displaying the username of the user you ignored or unignored, while in the away notification message, it’s displaying the username of the user who highlighted you while you were away.

Away system 3

SuperdAmn includes functionality that lets you notify other deviants of when you’re away from the chats, and when you’re back again. The following commands are utilized in any chatroom to do this:

• /setaway <reason> — Set your status to away with the given optional reason. This reason will be displayed to users that highlight you while you’re away, if you haven’t turned off away notifications.
• /setback — Sets your status back to normal after being away, and notifies everyone that you’re back.

When you’re away, your away message will be displayed in the bottom right corner to remind you that you are away (Pictured), so you don’t forget to turn it back off once you’re back again. Additionally, when you’re back, the script tells you for how long time you’ve been away.

Your away/back/notification messages can be changed in the Preferences panel.

There are certain chatrooms where away/back announcements are not displayed, usually because these disruptions not wanted in these rooms. So far, these are: #devart, #devious, #fella, #help, #MNAdmin, #IdleRPG, #iRPG, #Trivia and #photographers.

Emotes system 4

SuperdAmn allows for custom emotes that are not in the official emoticon legend to be inserted in any chatroom in which you have thumbnail privileges. The way it works is that it converts any given emote code to a thumbcode, and rendering gif and png thumbs without shadow, making emote thumbs appear like real emotes.

The emotes feature is not turned on by default. You have to navigate to the Preferences panel and turn it on from there. Then you can use the emoticon picker (pictured) to preview emotes and add them to your message.

SuperdAmn has two methods which you can store your favourite custom emotes; on the public Emotecloud database or on a personal, local list. The difference is that everyone can add emotes to the public list, and if you have it set as on in your preferences, you can use each and every one of the emotes. However, not everyone likes the same emotes, and so democracy reigns. Anyone can vote any certain emoticon up or down, and if you don’t like the code used for a particular emoticon, you can just add it with an alternative code. If people like that better, then that code will be the one used for that certain emote. To be able to be used in the chatrooms, emotes from the public database needs to have a vote of at least +5. When you add an emote to the database, it has +3, and you thus have to get at least two other people to vote it up. (More information on how the emote database works)

However, if there’s a particular code/emote combination that only you would like, or you would like to keep for yourself, you can add it to your personal emote list. It’ll then work immediately, as there is no voting. It’s your list, and you decide. You can also use it to overrule certain emote codes on your machine if you have public emotes turned on. For example, if there’s a particular emote in the public database you don’t like, and you’d rather use another code, you can just add that code to your own list with another deviation, and that one counts. Your personal list always overrules the database. Because it’s your installation!

There is a couple of additional possibilities when it comes to the personal list. While in the public database you can only add emotes with codes that are enclosed by :’s, (e.g. :emote:), a code can be anything on your personal list, so faces like :F or :V are only possible here. Additionally, you can choose to have the code replaced with any arbitrary set of text or dA HTML code instead of a thumb. For example, you could have the code :hd: turn into a Help Desk link. It’s very powerful if you have certain snippets you want to give people often!

But since private lists are tied to that one computer, you can only use them there. However, in the Preferences panel, there’s functionality that allows you to export your personal list of emotes. When you click the button, you get some code that includes all of your personal emotes. Then, when you want to put them on another computer, simply click the Import button and paste in the code. You can also use this to create emote packs that you want to share — simply send the code that has the group of emoticons and tell others to import it!

You can search for emotes within the emote picker, but you can also use the command /emotesearch <query>. To open the emote picker, you can use the command /emotes.

Titles and topics 5

The script includes various functionality to aid the changing of topics and title. The main feature is a visual dynamic topic/title editor. Move your mouse over any topic or title and you see an edit button in the corner. Click this and the topic/title in question is turned into a textbox which you can edit the topic or title. You can then press submit, and it is done. Easy peasy!

In addition, there are also some commands to help you if you’d rather like to use the input field:

• /gettopic and /gettitle — Gets the topic/title code and puts it in the field prefixed with either /topic or /title, ready for editing. You can press ↵ Enter when you’re done.
• /topicadd <content> and /titleadd <content> — Adds the specified content to the end of the topic or title, with a space between the appended text and the original topic.

Help! Some thumbs don’t work in my room topic/title and I can’t see the edit buttons!

When this happens, SuperdAmn hasn’t loaded the topic/title properly, and this is most probably due to it being loaded before SuperdAmn was loaded. It is easy to fix however: Type /gettopic or /gettitle and press ↵ Enter. An error message should appear. Click the link to reload the topic and title in the current chatroom. It’ll look like both has been updated, but they have in fact not, and no one else can see the ** updated * messages. You can reload the topic/title even if you don’t have privileges to change the topic or title, so you can do it anywhere it doesn’t render properly.

Ignores 6

SuperdAmn includes functionality that allows you to add other users to an ignore list and thus have their messages hidden from view on your computer. This is done by using the following two commands:

• /ignore <username> — Adds the user given by username to your ignore list, hiding their messages in any chatroom from view.
• /unignore <username> — Removes the user given by username from your ignore list, once again showing their messages in any chatroom.

You can type /ignore list or simply /ignore to see your ignore list. It includes an interface to remove people from the list, and it shows you when you started ignoring them.

From the Preferences panel, you can decide whether the script should say an ignore or unignore message in the current chatroom, and you can additionally customize the messages from there. You can also select whether to use retroactive ignore (on as standard), which is a new type of ignore that removes all the previous messages of the user you’re ignoring. It also makes all messages reappear on unignoring, even if they were posted while you were originally ignoring them. If this is not turned on, no messages are changed retroactively and ignoring/unignoring only changes future messages.

FAQ-system 7

Also included is functionality that enables the use of pasting FAQs into dAmn. :faqXXX: codes become FAQ-questions, powered by magic.

Additionally, you can use the command /faqsearch <query> to find FAQ-entries for a specific term. In the results box (pictured), the FAQ numbers, questions and categories are displayed along with a button on the far right that adds the FAQ-code to the input box, so that you can use it in your message.

Private chats 8

SuperdAmn makes the native dAmn private chats more easily accessible. Simply use /chat <username> to open a private chatroom with that user. However, the other user can’t and won’t receive your messages before they themselves join the private chat by typing /chat <your username>. Because of this, the script tells you when you’ve joined a private chat where the other user is not present yet, and it lets you know when they leave/join, or if they are already there.

Additionally, since you can’t tab the other person in a private chat, SuperdAmn makes it so that anything you type in a private chat with the other user will automatically alert them as if you’ve highlighted them. Because who else could you be talking to?

Formatting buttons 9

The script adds formatting buttons at the bottom of your dAmn window, right above the input box. These allow you to easily add formatting codes to your messages. With all of them enabled, they look like the below:

The only button that will always be there, is the multi-line button, since it is a native function of dAmn. This is the icon with a document with lines of text. To the left, there’s the emote picker button that only appears if you have custom emotes turned on, and allows you to open/close the emote picker. If you have chosen that the emote picker should be on the right, this button will too be on the right. All of the buttons to the right of the multi-line button in the above screenshot are all buttons that add various types of formatting to your message. These can be turned on or off in the Preferences panel.

If you hold down the Alt key, two keys have alternate functionalities when you click them:

The insert thumb and insert code buttons change to insert external image and insert bcode, respectively, when you hold down Alt.

To see a list of all buttons and their hotkeys, read the next section.

Hotkeys 10

With SuperdAmn is included a range of hotkeys that perform a range of actions related to the scripts functionalities. Contrary to earlier userscripts, the hotkeys are implemented using access keys, which means that the modifier keys required to activate the hotkeys vary depending on which computer and browser you have. This is because different computers have different sets of modifier keys and how they are used may also be different. This makes sure that the SuperdAmn hotkeys work on every system, because they are never overridden by system hotkeys.

On Firefox for Windows and Linux, the modifier keys required to activate the hotkeys are ⇧ Shift + Alt, while on Firefox for Mac OS X, the modifier key is Ctrl. A table of all hot keys are seen below:

Action	Windows/Linux hotkey	Mac OS X hotkey
Open emote picker	⇧ Shift + Alt + E	Ctrl + E
Multi-line input	⇧ Shift + Alt + M	Ctrl + M
Bold	⇧ Shift + Alt + B	Ctrl + B
Italic	⇧ Shift + Alt + I	Ctrl + I
Underline	⇧ Shift + Alt + U	Ctrl + U
Insert link	⇧ Shift + Alt + L	Ctrl + L
Insert thumb	⇧ Shift + Alt + T	Ctrl + T
Superscript	⇧ Shift + Alt + Z	Ctrl + Z
Subscript	⇧ Shift + Alt + X	Ctrl + X
Code	⇧ Shift + Alt + C	Ctrl + C
Insert website	⇧ Shift + Alt + V	Ctrl + V
Change to chatroom tab number 1 to 9	⇧ Shift + Alt + 1–9	Ctrl + 1–9

Miscellaneous features 11

In addition to the bigger features, SuperdAmn has a range of minor features and fixes, and some of them are documented in this section.

Timestamps

By default, SuperdAmn adds a timestamp to the beginning of every message, showing exactly when you received the message. This is normally shown with a 12-hour clock (AM/PM), but can be changed to 24-hours in the Preferences panel.

Thumbnails

Great measures have been taken to ensure that every thumb (except for stored or mature deviations) will successfully display on dAmn. A lot of tweaks has been added to make sure the right image URL is found and displayed. Additionally, SuperdAmn removes the shadow from GIF and PNG thumbs, making emoticon deviation thumbs look like emotes. Another big feature is the addition of literature thumbs on dAmn with SuperdAmn. These should be fully functional and scrolling, just like when you’re browsing dA, and they should work with any literature deviation that does not have an accompanying image.

Clear all chatrooms at once

SuperdAmn adds the command /clearall that /clears all chatrooms you have open. It can often give a quick performance boost to clear all old messages.

Tab “fixing”

Normally, when someone leaves and joins in a chatroom that is not selected on your computer, its tab flashes almost the same color as it would do if somebody spoke in there. SueprdAmn “fixes” this by assigning another tab flash color to appear when someone speaks in the chatroom. Additionally it makes the highlighting flash more obvious. There are three different tab flashing styles you can select in the Preferences panel.

Tabbing people and chatrooms

SuperdAmn adds the ability to tab people in the room within a :dev...: or :icon...: code. Simply type :dev or :icon and then the first letter of the person’s username, and press Tab ⇆, and the code is completed with the tabbed username. You can then press Tab ⇆ more than once to get another username if possible. Additionally, if you type # and press Tab ⇆, you can tab through the chatrooms you’re currently in.

Multi-argument commands

A range of commands, /join, /part, /whois, /ban, /unban has been upgraded to handle more than one argument (which is, in these cases, either a chatroom or a username each).

Chatroom links

Links posted in a message that link to a chatroom (e.g. http://chat.deviantart.com/chat/xxxxxxx) are altered so that clicking them does not open a new window with this chatroom, but rather joins the chatroom in the current session. Additionally, any word prefixed with #-character (looking like a chatroom name) will turn into a link that also joins the chatroom of that name in the current session when clicked.

:mytime:

Type :mytime: as part of any message and it replaces it with the current time on your end in your message. Handy for telling people what time it is at your place.

Changelog 12

Below, the changes between from each version of SuperdAmn to the next are documented and dated:

1. 1.0beta2: New fixes! Multi-ignore. Basic extension system. Dec 1, 2009
2. 1.0beta1: Initial public beta release. Nov 28, 2009
3. 1.0beta0rev1–rev6: Private beta releases. Nov 23-28, 2009