### Applying GPL to New Programs Source: https://github.com/igo95862/bubblejail/blob/master/LICENSES/GPL-3.0-or-later.txt This is a template for including the GPL license terms in your new programs. It should be added to the start of each source file. ```text Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . ``` -------------------------------- ### Generate Desktop Entry Command Source: https://github.com/igo95862/bubblejail/blob/master/docs/breaking_changes.md Example command to regenerate a desktop entry for a Bubblejail instance, specifying the instance name and profile. ```bash bubblejail generate-desktop-entry --profile firefox Firefox ``` -------------------------------- ### GPL Notice for Terminal Interaction Source: https://github.com/igo95862/bubblejail/blob/master/LICENSES/GPL-3.0-or-later.txt This is a sample notice to be displayed by a program when it starts in interactive mode, informing users about its free software status and warranty. ```text Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. ``` -------------------------------- ### Launch Tor Browser Source: https://github.com/igo95862/bubblejail/wiki/Example:-setting-up-Torbrowser Navigates into the extracted Tor Browser directory and launches the browser using its start script. This tests the direct launch from the shell. ```shell [sandbox ~] cd tor-browser [sandbox ~] ./start-tor-browser.desktop ``` -------------------------------- ### Old TOML Configuration Format Source: https://github.com/igo95862/bubblejail/blob/master/docs/breaking_changes.md Illustrates the previous structure of the instance configuration file before version 0.3. ```toml executable_name = "/usr/bin/firefox" services = [ "wayland", "network", "pulse_audio", "direct_rendering", ] [service.home_share] home_paths = [ "Downloads",] ``` -------------------------------- ### New TOML Configuration Format Source: https://github.com/igo95862/bubblejail/blob/master/docs/breaking_changes.md Shows the updated structure for the instance configuration file introduced in version 0.3, with keys organized under 'common' and service-specific sections. ```toml [common] executable_name = "/usr/bin/firefox" [wayland] [network] [pulse_audio] [direct_rendering] [home_share] home_paths = [ "Downloads",] ``` -------------------------------- ### Create New Instance with Firefox Profile Source: https://github.com/igo95862/bubblejail/blob/master/README.md Use this command to create a new Bubblejail instance named 'FirefoxInstance' using the predefined 'firefox' profile. This command is useful for setting up a dedicated sandbox for the Firefox browser. ```bash bubblejail create --profile firefox FirefoxInstance ``` -------------------------------- ### Run an Existing Instance Source: https://github.com/igo95862/bubblejail/blob/master/README.md Execute this command to run an application within the sandbox environment of an existing Bubblejail instance named 'FirefoxInstance'. Ensure the instance has been created prior to running this command. ```bash bubblejail run FirefoxInstance ``` -------------------------------- ### Create Bubblejail Instance with Existing Profile Source: https://github.com/igo95862/bubblejail/wiki/Re‐using-profiles-for-similar-applications.-Example-with-qutebrowser-and-chromium. Use this command to create a new Bubblejail instance for an application, leveraging an existing profile (e.g., 'chromium') and disabling desktop entry creation. ```shell [username@hostname ~] bubblejail create --no-desktop-entry --profile chromium qutebrowser ``` -------------------------------- ### Generate Desktop Entry for Sandboxed Application Source: https://github.com/igo95862/bubblejail/wiki/Re‐using-profiles-for-similar-applications.-Example-with-qutebrowser-and-chromium. After creating the Bubblejail instance, use this command to generate a desktop entry for the sandboxed application, allowing it to be launched from the desktop environment. ```shell [username@hostname ~] bubblejail generate-desktop-entry --desktop-entry /usr/share/applications/org.qutebrowser.qutebrowser.desktop qutebrowser ``` -------------------------------- ### Create Generic Instance Without Desktop Entry Source: https://github.com/igo95862/bubblejail/blob/master/README.md This command creates a generic Bubblejail instance named 'Test' without generating a desktop entry. It utilizes the 'generic' profile and is suitable for creating basic sandboxes for testing or applications that do not require a desktop shortcut. ```bash bubblejail create --no-desktop-entry --profile generic Test ``` -------------------------------- ### Register Tor Browser as a desktop app Source: https://github.com/igo95862/bubblejail/wiki/Example:-setting-up-Torbrowser Registers Tor Browser as a desktop application within the sandbox, creating a .desktop file in the sandboxed applications directory. ```shell [sandbox ~] ./start-tor-browser.desktop --register-app Launching './Browser/start-tor-browser --detach --register-app'... Tor Browser has been registered as a desktop app for this user in ~/.local/share/applications/ ``` -------------------------------- ### Create a new Bubblejail instance Source: https://github.com/igo95862/bubblejail/wiki/Example:-setting-up-Torbrowser Creates a new generic Bubblejail instance named 'tor_browser'. The generic profile allows access to common resources like windowing and sound. ```shell [username@hostname ~] bubblejail create --no-desktop-entry --profile generic tor_browser ``` -------------------------------- ### Run a terminal inside the sandbox Source: https://github.com/igo95862/bubblejail/wiki/Example:-setting-up-Torbrowser Launches a terminal emulator (e.g., Alacritty) within the 'tor_browser' sandbox. This terminal is isolated from the host system. ```shell [username@hostname ~] bubblejail run tor_browser alacritty ``` -------------------------------- ### Download Tor Browser archive Source: https://github.com/igo95862/bubblejail/wiki/Example:-setting-up-Torbrowser Downloads the Tor Browser archive using wget within the sandboxed terminal. Ensure you check the official website for the latest version. ```shell [sandbox ~] wget 'https://www.torproject.org/dist/torbrowser/13.0.10/tor-browser-linux-x86_64-13.0.10.tar.xz' HTTP request sent, awaiting response... 200 OK Length: 114603108 (109M) [application/x-xz] Saving to: ‘tor-browser-linux-x86_64-13.0.10.tar.xz’ ``` -------------------------------- ### Update desktop entry database Source: https://github.com/igo95862/bubblejail/wiki/Example:-setting-up-Torbrowser Updates the desktop entry database after modifying the .desktop file. This command makes the changes recognized by the desktop environment. ```shell [username@hostname ~] update-desktop-database ~/.local/share/applications/ ``` -------------------------------- ### Generate and modify desktop entry with Bubblejail Source: https://github.com/igo95862/bubblejail/wiki/Example:-setting-up-Torbrowser Uses Bubblejail to generate a modified desktop entry for Tor Browser, adjusting paths for the sandbox environment. This step is crucial for integrating the application with the host's desktop. ```shell [username@hostname ~] bubblejail generate-desktop-entry --desktop-entry ~/.local/share/bubblejail/instances/tor_browser/home/.local/share/applications/start-tor-browser.desktop tor_browser ``` -------------------------------- ### Manually edit desktop entry icon path Source: https://github.com/igo95862/bubblejail/wiki/Example:-setting-up-Torbrowser Manually edits the generated desktop entry file to correct the absolute path to the Tor Browser icon. This ensures the icon displays correctly in the desktop environment. ```shell [username@hostname ~] nano ~/.local/share/applications/start-tor-browser.desktop ``` -------------------------------- ### Extract Tor Browser archive Source: https://github.com/igo95862/bubblejail/wiki/Example:-setting-up-Torbrowser Extracts the downloaded Tor Browser archive file within the sandbox. This command unpacks the compressed tarball. ```shell [sandbox ~] tar --verbose --extract --file ./tor-browser-linux-x86_64-13.0.10.tar.xz ``` -------------------------------- ### PGP Public Key Source: https://github.com/igo95862/bubblejail/blob/master/SECURITY.md This is the PGP public key to be used for encrypting messages when reporting security vulnerabilities. Ensure your communication is encrypted using this key. ```text -----BEGIN PGP PUBLIC KEY BLOCK----- mDMEXi+3DhYJKwYBBAHaRw8BAQdAIoAeYBxPsLofRlh+Z13QSm0q8CsAUjxmbHpj +0zQPgu0HWlnbzk1ODYyIDxpZ285NTg2MkB5YW5kZXgucnU+iJAEExYIADgWIQRa PQZXampnRD376FbxpV5ilRshQwUCXi+3DgIbAwULCQgHAgYVCgkICwIEFgIDAQIe AQIXgAAKCRDxpV5ilRshQ1PwAP9EgUa6RjpB19CtjNqVMEYZbUX5MwROdb/ep/7w Nsn1ogD/SllYDzoSz3+J9OoZCU3pjX4QcZpTUnuJp2NGCifKHgi4OAReL7cOEgor BgEEAZdVAQUBAQdAhU+LfYuv1x9Gr85MXE5ISEmJlxsfDRO8Z+kd8RWIXF0DAQgH iHgEGBYIACAWIQRaPQZXampnRD376FbxpV5ilRshQwUCXi+3DgIbDAAKCRDxpV5i lRshQ2fOAP9jJIiGoLmBkfKpFTEz8hCmchVJ+Srrac9Cbx2MA9Q7EQD+NiI7WOYm maN7qsisk7k+wZcVrO7KvZwypmje7tVw0gQ= =1YqG -----END PGP PUBLIC KEY BLOCK----- ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.