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.
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.
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.
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.
Disabling an app, will no longer load, and therefore you'll no longer receive messages and notifications.
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.
Set this option if you intend to receive notifications of your app.
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
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.
Select which language you want the spell checker to work with within the app.
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.
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.
*The following options may cause security problems, use them responsibly. To apply any of these options, you need to restart the 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.
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.
You can apply style sets from User Styles to your app. Insert the style URL here to apply it.
Sets the user agent for the app before the page is navigated to.
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.