Article updated for v2.1.4.

Adding custom apps is pretty similar as adding common apps (How to create and configure Apps?). Just go to the apps tab bar and click on the "plus" button. Instead of selecting an app from our list of apps already available in Rambox, you'll need to click on the "Add Custom App" button. Now you'll see a left panel appears. Configurations there are the sames as for a regular app.

You can always propose us to add your custom app to our preconfigured ones in Rambox. We'll be happy to evaluate each case.

For custom apps, you can either manually register a local 128px x 128px PNG logo, or get the app's favicon from its URL by clicking on this button:

If Rambox cannot find the logo through this option, you can still add the custom app and the icon will be fetched in the apps' tab:

Once that's done, you can right-click on the app's icon, go to "Settings", and click the "Get app logo" button again.


If the app you are adding is not notifying you on any activity (new messages, new emails, etc.) through the title of the page (i.e.: "(2) Facebook Messenger") you can fix it by using the "Inject JavaScript Code" field in the Advanced Options.

Here is an example code that you can start with:

function checkUnread() {
    var e = document.getElementsByClassName("unread_countValue");
    var t = 0;
    for( i = 0; i < e.length; i++ ) t += parseInt(e[i].innerHTML.trim());

function updateBadge(e) {
    e >= 1 ? document.title = "(" + e + ") " + originalTitle : document.title = originalTitle
var originalTitle = document.title;
setInterval(checkUnread, 3000);