Desktop Maven - Version 1.00 - 27 September 2017

Copyright 2017 C. D. Goldin

This program saves, restores, aligns and imports desktop icon positioning on Ubuntu and Mint desktop systems using the default file managers.

It has been tested with:
Ubuntu 14.04 with Nautilus --- yet to be done
Mint 18.1 Cinnamon with Nemo
Mint 18.1 Mate with Caja --- yet to be done
Mint 18.2 Cinnamon with Nemo
Mint 18.2 Mate with Caja

It SHOULD work with other systems, as long as they are using Nautilus, Nemo or Caja. In the event that it does not work on your system, please let me know by email, and I will try to make the necessary code adjustments for you.

Package requirements: bash, grep, gsettings, gvfs-info, gvfs-set-attribute, sed?, xprop, zenity

Functions: This script provides a GUI interface for all actions:

          Saves the current icon layout to a file

          Aligns the icon positions to a user-defined grid, saving the new layout to a file

          Restores the icon layout using the previously saved file (in the event that the icon layout is destroyed by any of several anomalies.

          Imports an icon layout from another desktop. (This is useful for users who switch desktops (e.g. between Cinnamon and Mate on Linux Mint)).

          Converts desktop layouts when there is a change of screen resolution or the "default icon zoom level" or the "Desktop Icon Size" (cinnamon), allowing you to restore the same layout as before under the new sizing.

          But it WON'T mow the lawn.


#### Installation Instructions ####

1. Copy the three files:


to either your bin or nautilus scripts folder, or a subfolder with the name of your choice:

(/home/YourUserName/bin) or
(/home/YourUserName/.local/share/nautilus/scripts) or
(/home/YourUserName/bin/anysubfolder) or

#### Initial Setup ####

1. Make the script executable and run the script. You will be given the option to create a desktop icon to launch the application on the first script run.

2. On the first run, two files will be created in the installation directory:

Desktop_Maven.ini (where your preferences are saved)

And cinnamon.db (if you have a cinnamon desktop)
    or mate.db         (if you have a mate desktop)
   or [nautilus.db    (if you have a nautilus desktop)

The .db file is where your desktop layout is stored for subsequent restoring

3. If you are running the program on Linux Mint 18.2 Cinnamon, you will be asked to provide the "Desktop Icon Size" (which you can obtain (or change) by right-clicking on the Desktop, and then clicking "Desktop > Icon Size". This is necessary because Linux Mint 18.2 Cinnamon no longer shares this vital information with the user. (A curse on the developers for this omission.)

4. You will be asked to specify your language from a menu. If your language does not appear, see instructions below for how to add it.

#### Running the program after setup ####

There are seven options:

1. Save current desktop icon positions - This creates a file (cinnamon.db, mate.db, or nautilus.db), which can be used to restore the icon layout subsequently, when/if it becomes necessary.

2. Restore saved desktop icon positions - This restores your desktop layout from the file created by the last "Save" operation for your desktop manager (i.e. cinnamon, mate, or nautilus).

If your screen resolution or desktop zoom level have changed, you will be given the choice of restoring without any conversion, converting based on algorithms, or cancelling the restore operation.

If there has been a small change in the screen resolution, or the new resolution is larger, you can do a restore without conversion, although you may wish to do restore with conversion to utilize more of your desktop space.

If there has been a change in the zoom level, you will probably wish to do a restore with conversion, but you will probably have to manually rearrange the
icons if the new zoom-level is larger.

In either case, you will be given the choice of accepting the restored layout or returning to the previous layout (that you had before you did the restore.
Then you can try the other restore method, to see if it yields a better result. If you are happy with the new layout, you should do a "Save" afterward.

3. Import saved icon positions from another desktop - This restores your desktop layout from a file created (with this program) from another desktop. I.e. if
you are switching from Mate to Cinnamon or Nautilus, or from Cinnamon to Mate or Nautilus, or from Nautilus to Cinnamon or Mate, this function will allow
your to (approximately) preserve the desktop layout you were using under the other desktop session.

You will be given the choice of restoring without any conversion, converting based on algorithms, or cancelling the restore operation.

If you are converting betwen Linux Mint 18.2 Cinnamon and Mate or Nautilus, restoring with conversion will probably be your best choice. This is because
Linux Mint 18.2 Cinnamon handles desktop icons totally differently than in the past.

If you are not converting between other systems, restoring without conversion will probably be your best choice, as the other systems handle desktop icons


If there has also been a change in the screen resolution or the zoom level, see above under item 2 (Restore saved desktop icon positions).

As with "Restore saved desktop icon positions", you will be given a choice whether or not to accept the restored layout. If you accept it, the new layout
will automatically be saved to the .db file for your desktop.

4. Align icons to matrix & save.

5. Configuration - This allows you to change language, the Mint 18.2 Cinnamon icon size, and various criteria used by the align function


<describe them here>

6. Help - Displays this Help text.

7. About - Displays version and GNU information

#### Language Translations ####

The program supports multiple languages by using the file "languages.dta". To add support for your language, just add your translations to the file, using any text editor. Use the English translations as a template for your language. Your new language will automatically appear as an option in the language field of the configuration menu.

#### Creating a desktop icon ####

1. The program will prompt you to create a desktop icon to launch the application on the first script run. If you did not create a desktop icon on the first script run, you can delete the file "Desktop_Maven.ini" and then the next time you run the script it will prompt you again to create the desktop launch icon.

### Acknowledgements ###
I based this program on Desktop-Restore by Jamie O'Connel, Happy Desktop by Daniel RM, and several other Bash scripts that were posted online, but I coded it from scratch, and implemented many of my own ideas.

#### Change log ####
Version 1.00 ... original release

Download Desktop_Maven

Copyright 2015 - Carl D. Goldin - All rights reserved.

 people have downloaded this program to date

If you found this program useful, please consider a small donation. Thank you.

Donate via Paypal