Lumina® provides many built-in utilities, which are described in this chapter.
The Lumina® Archiver, seen here in Figure 5.1.1, provides compression/decompression services for a wide variety of file types. It is listed with other utilities in the GUI, or can be opened with lumina-archiver in a CLI.
The File and Edit categories contain all operations for the utility, which are also reproduced in the icon toolbar. Table 5.1.1 lists all operations for the Archive Manager:
|New Archive||File||Page with White Plus||Ctrl + N||Opens a window to create a new archive file|
|Open Archive||File||Folder with File||Ctrl + O||Open an existing archive|
|Quit||File||None||Ctrl + Q||Exit the utility|
|Add File(s)||Edit||Page with Green Plus||None||Add a file to an open archive|
|Add Directory||Edit||Folder with Plus||None||Add a full directory to an open archive|
|Remove File(s)||Edit||Page with Red X||None||Removes the selected file from the archive|
|Extract All||Edit||Page with White Arrow||Ctrl + E||Opens a window to extract the entire contents of the archive|
|Extract Selection||Edit||Page with White Arrow||None||Opens a window to extract the highlighted archive contents|
The primary window under the icon toolbar displays several elements:
- Archive: The full pathway to the opened archived.
- File: Lists the names of the files in the archive.
- Mimetype: Lists the mimetypes of archived files.
- Size: Displays the total size of the archived files.
The small section under the primary window will display any tooltips when hovering over an icon, as well as messages indicating an operation’s success or failure.
The Lumina® calculator utility is designed to provide a simple and intuitive interface paired with advanced functions and features. Open the calculator through the Utilities category of the application list, or by typing lumina-calculator in a CLI. The interface is seen in Figure 5.2.1:
The calculator is configured to use a numpad, if one is available. Enter the values and an operation, and the calculator displays the answer in the upper window. Select an equation displayed in the upper window to paste it in the entry field. On the right side of the output display are two icons. Press the Paper with red circle to clear the entire output history. Press the disk and pencil icon to save the calulator history as a basic text document.
Lumina® Calculator also supports a variety of advanced operations, seen in Figure 5.2.2.
These advanced operations can be selected from the drop down menu, or typed manually. The full list of available operations is seen in Table 5.2.1.
5.3. Insight File Manager¶
The Insight file manager, shown in Figure 5.3.1, allows the user to easily browse and modify files on the local system on a per-directory basis. To open Insight, click the start menu and select Browse Files, right-click the desktop and select Browse Files, or type lumina-fm from an xterm.
If Insight is already open lumina-fm will not open
a new window, but instead activate the currently open instance of
Insight. Open a new window of Insight with
Ctrl + N from
The top menu bar offers a wide variety of options for controlling Insight:
File: Contains basic options for manipulating Insight, seen here in Table 5.3.1.
¶ Name Shortcut Description New Window Ctrl + N Creates a new instance of Insight New Tab Ctrl + T Opens a new tab in Insight Search Directory Ctrl + F Opens Lumina® Search Close Tab Ctrl + W Removes an open tab Exit Ctrl + Q Closes Insight
View: Presents options to alter what Insight will display to the user. Table 5.3.2 shows the current options in the View tab:
¶ Name Shortcut Description Refresh F5 Reloads the current location Show Hidden Files Ctrl + H Insight will display all files marked hidden View Mode None Basic: Displays only the names of files an directories. Advanced: Displays Name, Size, Type, Date Modified, and Date Created for each file or directory.
Bookmarks: The Bookmarks not only gives options to add and manipulate internal links for quick navigation with Insight, but will display any created bookmarks in the menu as well. Table 5.3.3 describes all these elements:
¶ Name Shortcut Description Manage Bookmarks Ctrl + B Allows modification or removal of bookmarks Add Bookmark Ctrl + D Creates new bookmark of current location Bookmark Display None Populates with bookmarks as they are created
External Devices: Any attached devices with storage will appear in this menu. Click Scan for Devices if an attached device does not appear.
Git: GitHub functionality is natively built into Insight. Currently, Repo Status will display which branch is active, the update status with the origin repo, and any changes to commit. Clone Repository opens a wizard to download a git repository from the internet, seen in Figure 5.3.2.
Clone Repository will deactivate when Insight navigates inside a directory already labeled as a git repository.
Underneath the top menu bar is a navigation bar with even more options. From left to right, Table 5.3.4 describes each icon:
|Left Arrow||Go back to previous directory|
|Up Arrow||Go to parent directory|
|House Icon||Go to home directory|
|Text Field||Path to current location/Manual navigation field|
|Table with red minus||Single column view|
|Table with green plus||Dual column view|
|Horizontal lines icon||Additional file and directory operations (also available by right-clicking in the display area)|
Pressing the Green Plus Columns button next to the navigation field activates columned browsing, displaying two independent instances of the file manager in a side-by-side view, seen in Figure 5.3.3.
In columns mode, the active column has a white background. All the menu options and ZFS functions apply to only the active column.
The Horizontal Lines Icon shows file and directory operations, commonly seen in the right click menu when an item is selected. The directory operations are always available, and, like the name implies, provide options affecting the entire directory. Table 5.3.5 shows each of these options, split into the Create... and Open... categories:
|File||Create||Ctrl + Shift + F||Create new file|
|Directory||Create||Ctrl + Shift + N||Create new directory|
|Application Launcher||Create||Ctrl + G||Launches wizard to create link to desired application|
|Terminal||Open||F1||Launches the default terminal set to the current directory|
|Slideshow||Open||F6||Creates and populates a slideshow within a new Insight tab|
|Multimedia Player||Open||F7||Opens the directory with the default multimedia player|
Once an item is highlighted in Insight, a number of file operations become available, seen in Table 5.3.6:
|Open||None||Double-Click||Open the file or directory with the default applications|
|Open With||None||None||Opens the file or directory with a chosen application|
|Cut Selection||Modify Files||Ctrl + X||Used with Paste to move a file|
|Copy Selection||Modify Files||Ctrl + C||Used with Paste to create an exact duplicate of the selected file|
|Rename||Modify Files||F2||Allows changing the title of the selection|
|Delete Selection||Modify Files||Del||Removes the selection from the system|
|Checksums||View Files||None||Displays the file’s checksum|
|Properties||View Files||None||Displays the file information of the selection|
|Paste||None||Ctrl + V||Used with Cut or Copy to move or clone files and directories|
The final element to the upper Insight menus, if configured, is the ZFS snapshot bar, seen as the long blue line in Insight. If the system is formatted with ZFS and snapshots of the current directory are available, this bar allows the user to view the current directory from previous snapshots. In other words, the user can see past instances of the directory, as long as ZFS is configured to take periodic snapshots.
Snapshots are organized with oldest to newest snapshots displayed on the line from left to right. The text box on the left side of the blue line shows the active snapshot. Click the text box to view the other snapshots and choose which snapshots to activate. A slider also exists which can be used to move the directory back and forward in time, according to the saved snapshots. The left and right arrows can also be used for this function.
Underneath the viewing area of Insight are Magnifying Glass icons, used to increase or decrease the size of the objects to display. Also, the bottom left corner will display tooltips about the highlighted object or other relevant information.
5.4. File Information¶
The lumina-fileinfo utility is used to open a graphical
window summarizing the size, permissions and ownership, creation time,
and last modification time of the specified file or directory. In the
example shown in in Figure 5.4.1, the user has typed
lumina-fileinfo Downloads from a terminal window to view
the file information of their
This utility provides information about the installed version of
Lumina®, as well as the license, acknowledgements, and project links.
To launch this utility, right-click the desktop and select
Preferences → About Lumina, click
Start Menu → Question Mark icon in
Preferences, or type lumina-info in a terminal
window. An example is shown in Figure 5.5.1.
The General tab contains a variety of information:
- Desktop Version: Indicates the version of Lumina®.
- OS Build: Indicates the operating system used to build this version of Lumina®.
- Qt Version: Click View Information to display the QT version and its license.
- Lumina Website: Click Lumina Website to open http://lumina-desktop.org/ in the default web browser.
- Ask the Community: Click Ask the Community to open https://webchat.freenode.net/?channels=%23lumina-desktop, a chat channel dedicated to Lumina® with many friendly and helpful users.
- Source Repository: Click Source Repository to open https://github.com/trueos/lumina in the default web browser.
- Report a Bug: Click Bug Reports to open https://bugs.pcbsd.org/projects/pcbsd in the default web browser. Refer to Report a Bug for instructions on how to submit a bug report.
The License tab contains the license text for Lumina®. Lumina® is licensed under a 3-clause BSD license.
The Acknowledgements tab contains a few elements:
- Project Lead: The name of the Project’s lead developer. Click the name to open his or her profile on GitHub in the default web browser.
- Contributors: Click Open in web browser link to open https://github.com/trueos/lumina/graphs/contributors.
- Sponsors: lists the official sponsors of the Lumina® Project.
To open a file, directory, or URL from the command line, type lumina-open followed by the full path to the file or the URL. This utility will look for an appropriate application to use to open the specified file or URL. If there is no default application registered for the input type, a small dialog will prompt the user to select which application to use, and optionally set it as the default application for this file type. As seen in the example shown in Figure 5.6.1, this dialog organizes the available applications into three types:
- Preferred: These applications register their Mime type with the system and can open that type of file. Also included are any applications used to open this type of file before, as it keeps track of the last three applications used for that file type.
- Available: Displays all the applications installed on the system, organized by category and name.
- Custom: The user can manually type in the binary name or path of the application to use. A search button is also available for the user to graphically search the system for the binary. Whenever text is entered, a check is performed to determine if it is a valid binary, changing the icon to a green checkmark or red X as appropriate.
This utility can be used to take screenshots of the desktop or selected
window and save them as PNG image files. To launch this utility, click
the start menu and select
Browse Applications → Utility → Lumina Screenshot,
right-click the desktop and select
Applications → Utility → Lumina Screenshot, type
lumina-screenshot from a terminal window, or press
The utility opens with the View tab open by default, as seen in Figure 5.7.1.
The top menu bar contains several common options, while the tabs contain configuration options for screenshots. Table 5.7.1 lists the options in this top menu bar:
|Capture||Ctrl + N||Take a screenshot.|
|Save As||Ctrl + S||Open the Save Screenshot window to designate and how to save the new screenshot.|
|Quick Save||None||Saves the screenshot to
Underneath the top menu bar are tabs for viewing and configuring screenshots.
The View tab displays the most recent screenshot. Adjust the slider on the left to zoom in or out on the screenshot. Click and drag anywhere on the screenshot to designate an area to crop. Click again to remove the highlighted area. When satisfied, click Crop to remove everything from the screenshot outside the highlighted area. Click Open With... to quicksave the screenshot and designate an application to view or further manipulate the screenshot.
Use the settings tab to configure how a screenshot is taken.
|Entire Session||Captures the entire screen.|
|Single Screen||For multi-monitor setups. The screen number can be selected for the screenshot.|
|Single Window||Captures a selected window. With this selected, click Capture, and click the desired window. The Include Borders checkbox is used to determine if the utility takes a screenshot of the window with its border frame.|
|Delay||Choose the number of seconds to delay the screen capture after pressing Capture.|
|Show warnings||Check this box to have the utility provide a popup prompt when closing without saving the screenshot.|
5.8. Lumina® Search¶
Lumina® Search provides options to find and launch applications or to quickly search for files and directories. The * wildcard can be used in the search terms and the search will include hidden files if the search term starts with a dot (.).
To start this utility, type lumina-search, press
Alt + F2, or go to the start menu and press
Browse Applications → Utility → Lumina Search.
Figure 5.8.1 shows a screenshot of this utility.
To open an application, begin to type its name into the search field (selected by default). The box below the selected Applications button displays any matching application names. To open an application, select the desired application and click Launch Item.
Click Files or Directories to change the screen slightly, as seen in Figure 5.8.2.
By default, a Files or Directories search is limited to the user’s home directory, as indicated by the Search: ~ at the bottom of the screen. Smart: Off indicates every subdirectory is included in the search, with no exlusions. Once subdirectories have been added to the exclusion list, Smart: switches to On, and the excluded subdirectories are shown on the Search: section of the menu. To add more search directories or to exclude subdirectories, click the wrench to see the screen shown in Figure 5.8.3.
Click the blue folder icon to change the starting search directory. For example, select Computer, then / from the Select Search Directory screen to search the entire contents of the computer. Click + to add directories to an exclusion list for searching. Delete an exclusion by highlighting its entry and clicking -. The Save as Defaults option is selected by default. Uncheck this option to return the all customized search settings back to their defaults after closing the menu.
5.9. Text Editor¶
The lumina-textedit utility is a plaintext editor with a number of basic options. Figure 5.9.1: shows the editor with no file opened.
Typing lte in the command line will also open the Lumina® Text Editor.
Clicking File presents options to create New File,
Open File, Close File, Save file, Save File As, and Close.
Click Edit to open options to Find and Replace, also
Ctrl-R, respectively. The
View tab can be used to alter Syntax Highlighting,
Line Numbers, Wrap Lines, and Customize Colors. By default,
brackets are highlighted, lines are numbered, and words wrap dynamically
with the edge of the window. Additionally, selecting
Customize Colors gives the option to alter all the default
text and highlight colors, as seen in Figure 5.9.2.
The lumina-xconfig utility is a graphical front-end to the
xrandr command line utility. It provides the ability to probe
and manage any number of attached monitors. To start this utility,
right-click the desktop and select
Preferences → Display or type
lumina-xconfig from a terminal window. This opens a screen
similar to the one shown in Figure 5.10.1.
In this example, two display inputs are attached to the system and their current screen resolutions are displayed. If the display input supports multiple resolutions, these all appear in the Resolution drop-down menu to select a different resolution.
If another display input is attached, the Add Screen tab is activated in order to configure the new input’s resolution. Additionally, the user can choose to make the new input the system default.