Customize the Rocket.Chat desktop app to control how you access downloaded files, manage updates, and configure your desktop experience.
Access downloaded files
The desktop app provides a centralized Downloads manager to track, search, filter, and access files saved across all your workspaces.
To access your downloads:
Open the Application menu by clicking the three-dot icon in the top bar or at the bottom of the left sidebar, depending on your workspace layout.
Select Downloads.
The Downloads page displays your downloaded files, grouped by download date.
When you download a file from any workspace in the desktop app, a download indicator appears in the title bar, showing the progress of your downloads.
Filter and search downloads
Use the left sidebar panel to narrow down your downloaded files:
Search: Type in the search field at the top of the sidebar to locate files by name.
Status: Filter by download state (e.g., Cancelled).
Type: Filter by file type, including Images, Videos, and Files.
Server: Filter by the workspace they were downloaded from.
Manage a downloaded file
Depending on the file and its download status, the following actions are available:
Quick look: Open or preview the downloaded file..
Show in folder: Open the location where the file is stored on your device.
Copy: Copy a direct link to the file.
Remove: Delete the entry from your downloads history.
Access the desktop app log viewer
The desktop app log viewer provides an integrated interface to inspect, filter, and export Rocket.Chat desktop client logs directly within the app.
To open the log viewer:
Select Help from the application menu bar.
Click Open log viewer.
The log viewer opens in a dedicated window.
Filter and view logs
Use the controls on the left pane to adjust viewing options and narrow down displayed log entries:
Filter | Description |
|---|---|
Levels | Filter logs by severity, such as Error, Warning, or Info. |
Servers | Filter logs associated with a specific connected workspace. |
Search logs | Search for specific text within the available logs. |
Show Context | Displays the context associated with each log entry. |
Show Server | Displays the Rocket.Chat server associated with a log entry. |
Wrap long lines | Wraps long log messages so they fit within the viewer. |
Collapse multi-line entries | Groups multi-line log entries into a single expandable entry. |
Auto Scroll to Top | Controls automatic scrolling behavior as logs are displayed. |
Show timeline | Displays the log timeline at the top of the viewer. |
Timeline overview
The timeline at the top of the log viewer provides a visual representation of log activity over time:
Peaks indicate periods with a high concentration of log events.
Select a point or range on the timeline to filter logs to that specific timeframe.
Combine timeline selections with filters to isolate specific incidents.
Manage log entries
Use the toolbar actions in the top-right corner to manage or export log data:
Action | Description |
|---|---|
Open Log File | Open the underlying raw log file in your system's default text editor. |
Show in folder | Opens the folder containing the log file. |
Refresh | Refreshes the log viewer and loads the latest log entries. |
Auto Refresh | Starts or stops automatic refreshing of the log entries. |
Copy | Copy selected log content to your clipboard. |
Save | Export and save the currently displayed logs as a file. |
Inspect a log entry
Each log entry shows information such as its timestamp, severity, context, server, and message. Multi-line entries can be expanded or collapsed to make longer log messages easier to inspect.
Next steps
Change desktop app theme and appearance preferences: Learn how to switch between Light, Dark, or System themes and customize your workspace list layout.
Configure video call desktop app settings: Set up system-wide call shortcuts, adjust screen-sharing behaviors, and configure in-app video window settings.
Review invalid SSL/TLS certificates in desktop app: View and manage your trusted or rejected custom certificate exceptions.