Article updated for v2.0.6.

In the main tab bar, you'll find a plus button. Also, you'll find this button within workspaces.




Once clicked, a drawer will open at the right of your screen.


Now you'll see a view with a filtered list with the most popular apps available in Rambox. You can get the full list, either selecting all in the category's selector.


Or by clicking in this button.


To find the apps that you are looking for, you can filter them by category or by searching specific words. If you can find the one that you need, you can always add it as a custom one.



Let's say that you want to add Gmail. Just click in Gmail and a new drawer with the app settings will open.


App's settings


Name

You can edit the app name by clicking in the edit button at the right of the name. This name will be displayed in the app toolbar. By default, it's the app's name.



URL

Some apps require you to configure a specific URL. You'll have to follow a given template. Some apps could have more than one template option: you must configure at least one of them.



App logo

Apps have their own logo as default image. You can change it with any image in your local machine. Must be a 128 x 128 pixels and PNG format. Clicking in the logo will open a dialog, so you can choose your file.



Enable app

Disabling an app, will no longer load, and therefore you'll no longer receive messages and notifications.


Allow sounds

Enable this option if you want Rambox to reproduce app's sounds. If you disable this option, this app will be muted.


Show app name

Set this option if you want to show the app's name in the app tab bar.


Allow notifications

Set this option if you intend to receive notifications of your app.


Profile

You can set a profile scheme for an app it can be a certain profile or "private" if you want that it have an isolated profile, the default value for a root level app will be "Primary"  and if is nested in a workspace it will be "Inherit from Workspace". Apps like WhatsApp, Android Messages, Discord are mostly used isolated from other that why they have a "Private" profile by default You can read more about profiles in this  LINK


Unread counter:


Display in tab 

Enable this option if you would like to see a badge in the app icon when you have unread notifications.


Include in workspace (non-root level)

Enable this option to add this app's unread notifications counter to the workspace unread counter.


Include in global (root level)

Enable this option to add this app's unread notifications counter to the global unread counter.


Spell checker

Select which language you want the spell checker to work with within the app.


Link handling

How links work inside this app.

  • Block all pop-ups: prevent all pop-ups from showing.
  • Open all internally: open links in a new Rambox window.
  • Open all in default browser: open links in your default browser.


Hibernate

Set time to hibernate app when idle for a while. This will release memory and improve performance. Set to 0 if you do not want the app to hibernate. When an app is hibernated, it will be disabled, and you won't get any notification from it. Most apps have a 15-minute default hibernation time, but not the ones that belongs to the Email or Messaging category. Also, there's the possibility to set that an app starts hibernated when Rambox initiate.



Advanced


*The following options may cause security problems, use them responsibly. To apply any of these options, you need to restart the app.


Inject JavaScript Code

You can inject custom JavaScript code into the app's website. This is great when you want to add custom functionality to each specific app.

For instance, some users wish to make an Auto-Refresh every X time because the app they are using, it's disconnect on inactivity. Here's an example script to auto-refresh the app every 10 minutes.


setInterval(function() {
    location.reload();
}, 600000);


Once you finish writing and testing your code, it will be a great practice to minify it before pasting it into Rambox. To minify it, you can use JSCompress.


Inject CSS Code

You can inject custom CSS code into the app's website. This allows you to change style details you prefer.

For instance, here's a script to change app's background color.


.background {
    background-color: gray;
}


Stylish URL

You can apply style sets from User Styles to your app. Insert the style URL here to apply it.


User Agent

Sets the user agent for the app before the page is navigated to.


Proxy

If you need to use a proxy server or application, here you can configure it.

  • No Proxy: do not use proxy.
  • HTTP, HTTPS, Socks, Socks4, Socks5: if you want to use a proxy, these options will show you some configuration fields for you to set.


Force Mobile Rendering

Some apps have different user interfaces depending on the device you access it. Set this configuration if you wish to force rendering the mobile alternative of the app.


Prevent Basic Auth

By default, Rambox shows a dialog where you can input the credentials needed to perform an HTTP basic auth, but in some exceptional cases, this dialog could interfere with some custom login flows. This option gives the possibility to disable that dialog.


After you configure these options, click the "Add" button. You'll see your app added to the tab bar where you click the plus button. Now you can log in to it.