Page 1 of 2

SandboxToys, a toolbox for Sandboxie: now v07.11.04.09

Posted: Thu Sep 06, 2007 6:59 am
by r0lZ
After having read some feature requests in this board, and figured out how Sandboxie works, I had the intention to post some requests myself. But since I have my own idea on how they should be implemented, I decided to write my own implementation of the tools I need. Of course, I would prefer to see those tools integrated in Sandboxie itself, but in the meantime, SandboxToys can be useful, so I decided to make it publicly available, as a freeware.

Download SandboxToys: SandboxToys.zip or Mirror.

The current version of SandboxToys is: 07.11.04.09
(The version number is the date of the last compilation, in the form YY.MM.DD.HH)

Installation: Do not try to run SandboxToys sandboxed, as it will probably not work properly!
To install it, extract SandboxToys from the archive, and place it in your Sandboxie installation folder, then right-click it and select Run As Administrator. It will install itself, and create some new shortcuts in your Start Menu. The file "SandboxToys_install.txt", included in the archive, gives more details.

To use SandboxToys, read the next post.

Please report bugs and feature requests in this thread. I don't have the intention to read the whole Sandboxie board!

Have fun!

SandboxToys user manual

Posted: Thu Sep 06, 2007 6:59 am
by r0lZ
SandboxToys user manual

SandboxToys is a toolbox for Sandboxie v3.01 or (hopefully) greater.
SandboxToys is mainly designed to ease launching programs that have been installed in your sandboxes, or to open any program or file sandboxed in any sandbox.
SandboxToys provides also some tools to explore, examine and maintain yous sandboxes in a variety of ways.

Installation:

Extract SandboxToys.exe from the zip archive and place it in your Sandboxie installation folder. Then, launch it. SandboxToys will install itself automatically.
Read also SandboxToys_install.txt, included in the archive. It gives more details.
Note that you cannot uninstall SandboxToys from the standard "Add or Remove Programs" control panel, but you can uninstall it with the "Uninstall or Repair SandboxToys" shortcut installed in your Start Menu.

Usage:

Several shortcuts have been created in the SandboxToys sub-folder of your Sandboxie Start Menu folder.
  • Main SandboxToys Start Menu
    This tool is the core of SandboxToys.
    When you launch it, it displays a little popup menu with a sub-menu for each Sandbox that has been properly configured and created with Sandboxie. Note that only the sandboxes that are currently not empty are displayed in the menu.
    The structure of that popup menu is:
    • <Sandbox_name>
      Each sandbox is represented by a sub-menu with the following menu items:
      • Tools sub-menu:
        • Mirror Shortcuts in Start Menu
          Mirror shortcuts are shortcuts installed in your regular Start Menu, by default in the folder "[#] Sandboxes [#]\<Sandbox_name>". Those shortcuts can be used to launch the programs that have been properly installed in the sandbox "<Sandbox_name>". They are launched automatically sandboxed in the same sandbox.
          When you select "Mirror Shortcuts in Start Menu", SandboxToys scans the sandbox folder, and duplicates the shortcuts it finds in the Start Menu, Desktop and Quick Launch folders of your sandbox to your regular Start Menu.
        • Delete Dead Mirror Shortcuts
          When a program is uninstalled form a sandbox, the shortcuts created by the previous option are not removed automatically.
          Delete Dead Mirror Shortcuts can be used to find the sandboxed shortcuts in the "[#] Sandboxes [#]\<Sandbox_name>" folder of your regular Start Menu that are not pointing to an existing target any more, and to delete them.
          Note: When you create a mirror for the first time, an new shortcut is created also in the mirror's root folder of your Start Menu, called "Delete dead shortcuts". This icon can be used to delete ALL dead shortcuts of ALL sandboxes that have been mirrored so far, without confirmation!
        • Sandboxie's Run Dialog
          Launches the regular Run Dialog of Sandboxie, but automatically sandboxed in the right sandbox instead of the "DefaultBox".
        • Sandboxie's Start Menu
          Launches the regular Start Menu of Sandboxie, but automatically sandboxed in the right sandbox instead of the "DefaultBox".
        • Sandboxed MS-DOS command prompt
          Launches the command prompt, sandboxed in the right sandbox. The current directory is set automatically to the path of your sandbox.
        • Registry Editor
          Launches the Registry Editor, sandboxed or unsandboxed, and opens automatically the key corresponding to the sandbox.
          Note that when it is run unsandboxed, the standard Run dialog is also opened. This is necessary to force Sandboxie to link the RegHive file of the sandbox to the registry. Do not close the Run dialog while you are working in the registry editor (unless you are sure that another program is currently running sandboxed in that sandbox.)
        • Add or Remove Programs
          Launches the Add or Remove Programs control panel, sandboxed.
          All programs installed on your system and in the sandbox are listed. If you uninstall a program that has been installed in the sandbox, it will be completely uninstalled.
          If you uninstall a program that has been installed unsandboxed, it will disappear from the sandbox, but will still be available outside of the box. This can be useful if you need to hide a program in a specific sandbox.
          You can also use this control panel to install a new program in the sandbox.
        • Delete Fake Files and Folders
          When a file is deleted by a sandboxed program, Sandboxie leaves an empty file in your sandbox with a "magic" creation date to recognize that the file doesn't exists any more "officially". However, those fake files are necessary only when a file of the same name exists in the corresponding folder outside of the box.
          Those empty files consume some disc space and make it difficult to browse your sandbox folder. Use "Delete Fake Files and Folders" to remove them completely.
        • Terminate Sandboxed Processes
          Does exactly the same thing than the regular Sandboxie tool of the same name, except that it works on the sandbox of the menu, and not the sandbox that is current in Sandboxie Control.
        • Back Sandbox up to ZIP file
          Creates a ZIP archive with the content of the sandbox. It is highly recommended to quit all applications running in the sandbox before calling this function, as they will be killed any way!
          A log file is created in case of error. Do not trust a backup that has failed!
          If a malware has infected your sandbox, simply delete it and restore the backup manually.
        • Delete Contents of Sandbox
          Does exactly the same thing than the regular Sandboxie tool of the same name, except that it works on the sandbox of the menu, and not the sandbox that is current in Sandboxie Control.
      • Explore sub-menu:
        • Sandboxed
          Launch a sandboxed explorer to explore the Sandbox folder.
        • Sandboxed, Restricted
          Launch a sandboxed explorer to explore the Sandbox folder. You cannot browse outside of the sandbox (although it is still possible to type any folder name in the address bar.)
        • Unsandboxed
          Launch an unsandboxed explorer to explore the Sandbox folder.
        • Sandboxed, Restricted
          Launch an unsandboxed explorer to explore the Sandbox folder. You cannot browse outside of the sandbox.
      • Desktop sub-menu:
        This sub-menu is only available if there are files or shortcuts in the Desktop folder of the sandbox (or in its sub-folders.)
        It contains a menu item for each file or shortcut found in the sandboxed Desktop. Use those menu items to launch the file, automatically sandboxed.
        This function is similar to the regular Start Menu -> Desktop of Sandboxie, except that it displays the files that are installed in the desktop of the sandbox, and not in your regular Desktop, and that it launches the file sandboxed in its own sandbox, and not in the "DefaultBox".
      • Quick Launch sub-menu:
        This sub-menu is only available if there are files or shortcuts in the Quick Launch folder of the sandbox.
        It contains a menu item for each file or shortcut found in the sandboxed Quick Launch folder. Use those menu items to launch the file, automatically sandboxed.
      • All Users Start Menu:
        This sub-menu is only available if you have installed some programs in the sandbox, and if those programs have created some shortcuts in the start menu for all users.
        Click on this item to explore the All Users Start Menu of your sandbox. Explorer runs sandboxed and restricted to that Start Menu folder. You can easily launch any shortcut that have been installed by the programs in your sandbox.
      • Other sub-menus under "All Users Start Menu":
        They duplicate the structure of the All Users Start Menu of the sandbox.
        You can launch the installed programs easily from those sub-menus, sandboxed.
      • User Start Menu:
        This sub-menu is only available if you have installed some programs in the sandbox, and if those programs have created some shortcuts in the start menu for the current user.
        Click on this item to explore the Current User Start Menu of your sandbox. Explorer runs sandboxed and restricted to that Start Menu folder. You can easily launch any shortcut that have been installed by the programs in your sandbox.
      • Other sub-menus under "User Start Menu":
        They duplicate the structure of the Current User Start Menu of the sandbox.
        You can launch the installed programs easily from those sub-menus, sandboxed.
    • Sandboxie Control:
      Use this item to launch the regular Sandboxie Control panel, if it is not already running in your system tray. Useful if you have disabled the "Run Sandboxie Control on System Startup" option, or if you have closed Sandboxie Control manually.
    • Cancel:
      Close the SandboxToys popup menu without carrying out any action.
  • Run Program in Any Sandbox
    Select the program to launch from the File Open dialog that pops up, and then the sandbox to use in the little popup menu. The program will be launched sandboxed in that box.
    There is an easier way to launch this function. More on this in the "Right-click context menu" section below.
  • Create Sandboxed Shortcut
    With this tool, you can create a shortcut to any file on your computer to run it sandboxed in any sandbox.
    Select the file to run with the File Open dialog that pops up when you launch the tool. Then, defines the shortcut file to create with the File Save dialog.
    Now, if you have several sandboxes configured in Sandboxie, a popup menu opens where you can select the sandbox to use, or the special "_ask_" entry that lets you select the sandbox at run time.
    There is an easier way to launch this function. More on this in the "Right-click context menu" section below.
  • Delete Fake Files and Folders
    This tool allows you to delete the fake files and folders found in your sandboxes. See above for details.
    When you launch it, a dialog is displayed, where you can un-select the boxes you want to skip. Only the boxes that are currently not empty are displayed.
    This tool is similar to the "Delete Fake Files and Folders" option of the Main SandboxToys Start Menu, except that you can clean all sandboxes at once.
    Note that you can clean all sandboxes automatically without displaying the dialog by launching SandboxToys from the command line with the /CLEANUP and /QUIET options. This might be useful if you want to automatically clean all sandboxes at system startup.
  • Standard Sandboxie's Run Dialog
    This tool displays a little popup menu to select a sandbox and then calls the standard Run dialog of Sandboxie, sandboxed in that box.
  • Standard Sandboxie's Start Menu
    This tool displays a little popup menu to select a sandbox and then calls the standard Start Menu dialog of Sandboxie, sandboxed in that box.
  • Help about SandboxToys
    Displays two dialogs with a general help message and the command line usage of SandboxToys.
    The version number of SandboxToys is displayed in the title bar of those dialogs.
  • Edit SandboxToys configuration
    Opens the configuration file of SandboxToys in your favourite text editor. You can edit this file to modify some settings, such as the default icons to use for the sandboxed shortcuts, the text string to prepend to the sandboxed shortcuts names to distinguish them from standard shortcuts, or the default folder to use for the Start Menu mirror.
    The file is documented, and it should be easy to understand its usage and syntax. However, do not edit it if you don't understand it well!
    The configuration file, "SandboxToys.cfg", is in your %APPDATA% folder (usually "C:\Documents and Settings\<your login name>\Application Data\SandboxToys.cfg".)
    If, per chance, SandboxToys doesn't work well any more, you can try to delete or rename this file. SandboxToys will use its hard-coded defaults, and save the file again when you create a shortcut. If that doesn't work, try to repair or to uninstall and re-install SandboxToys.
  • Uninstall or Repair SandboxToys
    Launch this tool to uninstall SandboxToys, or, if you have trouble with some functions, repair it.
    Don't forget that it is NOT possible to uninstall or repair SandboxToys from the "Add or Remove Programs" control panel, so, don't delete this shortcut!
Right-Click Context Menus:

You can also launch some of the functions of SandboxToys by right-clicking on any file, folder or drive icon (except URL icons) to open its standard contextual menu.
There are two function available for all type of files and folders, an additional function available only in shortcut files (.LNK files) and a "Send To" sub-menu item.
  • Open in Any Sandbox
    Displays a popup menu to select the sandbox to use, and then opens the file or folder sandboxed in that box. If you have only one sandbox, the popup menu is not displayed.
    This function is similar to the "Run Program in Any Sandbox" tool, except that you don't have to browse to the file you want to open. It is also possible to open a folder (or even a drive) sandboxed by using its context menu.
  • Create Sandboxed Shortcut
    Opens the File Save dialog to select a shortcut to create, and then a popup menu to select the box to use, and creates a shortcut to launch the file automatically sandboxed in the selected box.
    If you have only one sandbox, the dialog is not displayed.
    This function is similar to the "Create Sandboxed Shortcut" tool, except that you don't have to browse to the file you want to create a shortcut for. It is also possible to to create a sandboxed shortcut to a folder (or even a drive) by using its context menu.
  • Open Sandboxed Container
    This function is only available in the context menu of the shortcut (.LNK) files.
    It allows you to open the folder containing the target file of the shortcut, sandboxed in any sandbox, or unsandboxed.
    A new popup menu is opened, where you can select the sandbox to use, or "Unsandboxed".
    This function works with any shortcut. When the shortcut is a sandboxed shortcut (as created by SandboxToys's Create Shortcuts or Mirrors functions), the sandbox used by the shortcut is highlighted in green in the popup menu. When you use this function on a standard shortcut, not sandboxed, the "Unsandboxed" option is highlighted.
  • Send To -> Any Sandbox
    Use this function to copy any file or folder from any location on your hard disc to the corresponding location in any sandbox. For example, a file on your desktop will be copied in the sub-directory <selected_sandbox_path>\user\current\Desktop.
    The same function can be used to do the opposite. When the source file or folder is already in a sandbox, the user has the option to "recover" it, that is to copy it from the sandbox to the corresponding unsandboxed location. The sandboxed file or folder can also be copied to another sandbox.
Command line arguments:
  • SandboxToys.exe [/MENU]
    Displays the main SandboxToys popup menu.
    The /MENU argument is optional. Therefore, launching SandboxToys.exe without argument opens also its main popup menu.
  • SandboxToys.exe /START_MENU
    Launch Sandboxie's Start Menu in ANY Sandbox.
  • SandboxToys.exe /RUN
    Runs any file or folder in any box.
  • SandboxToys.exe /RUN "file"
    Runs the specified file or folder in any Sandbox.
  • SandboxToys.exe /RUN_DIALOG
    Launch Sandboxie's Run Dialog in ANY Sandbox.
  • SandboxToys.exe /SC
    Creates a sandboxed shortcut. Prompts for the source file to create a shortcut for, the shortcut to create, and the sandbox to use.
  • SandboxToys.exe /SC "file"
    Same as above, but prompts only for the shortcut and the sandbox.
  • SandboxToys.exe /SC "file" "target.lnk"
    Same as above, but prompts only for the sandbox.
  • SandboxToys.exe /OPEN_CONTAINER "shortcut.lnk"
    Opens the real container folder of any shortcut, sandboxed or not.
    (To be used from the shortcut's context menu.)
  • SandboxToys.exe /CLEANUP
    Deletes fake files and folders in sandboxes.
  • SandboxToys.exe /CLEANUP /QUIET
    Silently deletes all empty files in ALL sandboxes!
  • SandboxToys.exe /DEL_DEAD_SHORTCUTS
    Deletes all dead shortcuts from your Start Menu mirrors!
    (To be used after having created mirrors with the /MENU option.)
  • SandboxToys.exe /HELP (or /?)
    Displays the SandboxToyx help message, version number, and command line arguments.
  • SandboxToys.exe /INSTALL
    Installs, uninstalls or repairs SandboxToys.
Known bugs:
  • It is not possible to open an URL shortcut in the standard File dialog of Windows, and there is currently no SandboxToys options in the context menus of the URL shortcuts.
There might be other bugs as well. Please report them in this thread. Thanks!

Posted: Fri Sep 07, 2007 12:50 am
by dlguild
r0lZ, the final version turned out very nice! All the functions seem to work as expected. Great job! Thanks! :D

Version 07.09.07.07 already released!

Posted: Fri Sep 07, 2007 1:11 am
by r0lZ
Well, thanks, but I have just posted another version, v 07.09.07.07, as with the original version, there is a problem when you re-install Sandboxie, or upgrade to a newer version. The shortcuts installed in the Sandboxie\SandboxToys sub-menu of your Start Menu during the SandboxToys installation are deleted by the Sandboxie installation procedure, and you have no way to uninstall SandboxToys any more, except by typing "SandboxToys.exe /install" in a command prompt or by recreating an "Uninstall SandboxToys" shortcut manually with the same command. Therefore, the new version installs the SandboxToys shortcuts in its own folder in your Start Menu.
It's the only modification I did since the original version 07.09.06.12.

v 07.09.12.11 released!

Posted: Wed Sep 12, 2007 4:23 am
by r0lZ
A new version of SandboxToys is available: v07.09.12.11
Download it from the first post of this thread.

New in v07.09.12.11:
  • New option in the main SandboxToys menu to back the content of any (non-empty) sandbox up to a ZIP file. To restore a damaged or infected sandbox, simply delete it completely, and restore the backup.
  • Since I've learned now how to distinguish "real" empty files intentionally left empty on the disc by a sandboxed application, and the "fake" empty files left by Sandboxie to represent a file that has been completely deleted by the sandboxed application, I have modified the CLEANUP function to delete ONLY those fake empty files, and ONLY when a file of the same name doesn't exist in the equivalent folder outside of the box.
    I have also renamed "empty file" to "fake file" in the messages and the name of the shortcuts. (To update the shortcuts, you have to uninstall SandboxToys and Install it again, or to use the Repair option of the uninstall process.)
  • A couple of little bugs have been fixed.
I have also modified the second post (the SandboxToys manual to reflect the changes.)

[EDIT] Oops! I forgot a bug in v07.09.12.10. The current version is therefore now v07.09.12.11! If you have downloaded v07.09.12.10, please download SandboxToys again, and overwrite SandboxToys.exe with the new version.
Sorry!

version 07.09.12.12

Posted: Wed Sep 12, 2007 6:20 am
by r0lZ
Yet another bug fixed in v07.09.12.12
  • The function to create a mirror of your sandboxed Start Menu in your standard Start Menu did not work for the All Users Start Menu.

Posted: Wed Sep 12, 2007 4:32 pm
by dlguild
Thanks again r0lZ! It just keeps getting better and better! :D

Version 07.09.14.10

Posted: Fri Sep 14, 2007 5:21 am
by r0lZ
New version 07.09.14.10, with some important changes and additions.
  • Added a shortcut in your "SendTo" folder to enable the context menu option "Send To -> Any Sandbox".
    This function can be used to copy any file or folder to its corresponding location in any sandbox.
    It can also be used to do the opposite. When the source file is already in a sandbox, the user has the option to "recover" it, and to copy it from the sandbox to the corresponding unsandboxed location. You can also copy a file or folder from a sandbox to another sandbox.
  • The shortcuts created by SandboxToys are now pointing to the (possibly non-existing) target file in the "real" fileststem, instead of the virtual target in the sandbox. This method should improve the reliability of the shortcut when the target program relies on its default startup directory to work properly.
    The same thing is true for the files launched via the main SandboxToys menu.
  • When SandboxToys creates a sandboxed shortcut, it tries now to find the original icon of any file type (and not just EXE files like before) or when the target file is also a shortcut, it uses the icon defined in the target shortcut (if any).
  • The shortcut's context menu "Open Sandboxed Container" offers now to open the real target folder instead of the equivalent folder in the box. (Only when the box selected by the user is the box containing the file pointed to by the shortcut and that the same file exists in and out of the box.)
  • Added a confirmation dialog to the potentially dangerous option "Delete Contents of Sandbox" of the main SandboxToys menu.
IMPORTANT: You need to re-install or repair SandboxToys to force it to create the new shortcut in your SendTo folder, otherwise you will not have the "Send To -> Any Sandbox" context menu.


@dlguild: Thanks for the thanks!

Version 07.09.14.21

Posted: Fri Sep 14, 2007 3:20 pm
by r0lZ
:oops: Last minute bug fixed in v 07.09.14.21!
  • The function to create a sandboxed shortcut did not work properly when the target file of the sandboxed shortcut is itself a shortcut. (The shortcuts were created but with the standard Sandboxie icon and without the comment. However, they worked as expected.)

Re: Version 07.09.14.21

Posted: Sat Sep 15, 2007 2:37 am
by dlguild
r0lZ wrote::oops: Last minute bug fixed in v 07.09.14.21!
No need for the red face. It didn't trash my drives or cause a BSOD! Keep up the good work! :D

Posted: Sat Sep 15, 2007 11:16 am
by SnDPhoenix
Yeah, I gotta say, although I don't really need this "addon", I gotta admit, your doing a good job keeping it updated, fixing bugs and adding new features. :wink:

Posted: Mon Sep 17, 2007 6:06 am
by r0lZ
Thanks. But I will probably leave it as it is now (unless some bugs are reported.) It does what I need, and I have to work on my big project, PgcEdit.

Posted: Mon Sep 17, 2007 11:30 am
by wraithdu
Holy crap!! I never put the two together! I love PgcEdit. Although I don't use it that ofter or for anything really complex, it's never let me down when I needed it. No wonder you're addon is so feature rich. LOL Keep up the good work!

Posted: Tue Sep 18, 2007 4:51 am
by r0lZ
The world is so small, dear PgcEdit user! ;)

Re: Version 07.09.14.10

Posted: Wed Sep 19, 2007 7:46 am
by LittleBiG
r0lZ wrote:New version 07.09.14.10, with some important changes and additions.
  • Added a shortcut in your "SendTo" folder to enable the context menu option "Send To -> Any Sandbox".
    This function can be used to copy any file or folder to its corresponding location in any sandbox.
I think "move" would be better and more logical. There is no reason to let file on the original location. And move would be faster than copy.

Your extension is really great, "Main SandboxToys Start Menu" is the most used function in my Sandboxie. Without SandboxToys Sandboxie would be very uncomfortable.