QTGZManager has basically three well defined use cases:

  • Manage/organize your package collection;
  • Maintain your system up to date, downloading latest Slackware patches;
  • Perform pkgtools actions like: install, reinstall, upgrade, downgrade and remove a package or a group of packages;

After you run the program for the first time, you’re presented to a screen like this:

QTGZManager basic screen

QTGZManager basic screen, as you start it for the very first time. Note that it’s black because I’m using a dark KDE/Qt4 theme.

The first thing you should do is to set default QTGZManager’s directory. This dir will always be selected when you start the application. See that yellow star in front of the blue “arnt” folder in the left pane? That’s the icon for “default directory”. To change that setting you just go the the desired directory, right click on it and select the option “Set as default directory”.

Setting default directory

You can set a default directory so every time you run QTGZ it’s going to be selected.

You certainly noticed the application has four basic panes:

  • The left one is called “Directory” pane. Pane1 has the directory tree of your system just as a File Manager. There you can create dirs, remove empty dirs, rename dirs (F2), open a File Manager of selected dir (F6) as well as open a Terminal of selected dir (F4);
  • In the middle we have the “Packages in selected directory” pane. On Pane2 you see all TGZ, TXZ and RPM packages you might have inside the selected directory of the first pane. You can drag those packages and drop them inside some other directory on the first panel just to move them to that dir (or use Ctrl+X/Ctrl+V). Note that every time you single click a package on that pane, it’s counterpart installed package (if any) at the rightmost pane is selected. Also, you can use Ctrl+C and Ctrl+V to copy them to whichever directory you want. Pressing F8 will give you it’s information, including any clickable url it might have. Double clicking will open it’s contents on the bottom pane;
  • On the very right we have “Installed Packages” pane. On Pane3 lies all installed packages of your Slackware OS (found in “/var/log/packages” dir). You can also press F8 to see it’s information, as well as double click it to view it’s contents on the bottom pane;
  • On Pane4, at the bottom, we have the “Actions” pane. An action is an abstraction QTGZManager creates every time you assign a pkgtools like action to some Slackware package, being it installed or not. A pkgtools action may be: install, reinstall, remove, upgrade or downgrade a package. Those actions are created whenever you right click a package on Pane2 or Pane3 and select the desired action from the context menu. Every user created action will be represented by it’s target package and is child of it’s respective kind, ex: “to be downgraded”, “to be installed”, “to be reinstalled” and so on. This panel also contains all the tabs QTGZ opens while in execution: the contents of any package the user wanted to see, the differences among package versions, the opened snapshots of installed packages, the official Slackware patches downloaded and the help file (F1);
Using package context menus

By the use of context menus, you can generate package actions and have access to the great majority of application’s features.

You can press F9 to hide/show Pane3. Pressing F11 will minimize Pane4. You can press F10 to bring QTGZ to default 4-Pane view. And pressing F12 will maximize Pane4, so you can navigate through some package content or see the entire help more comfortably. And every customization you may perform in the interface will be preserved in the future, including window’s size and position.

You’ll also notice a directory called “patches_slackware[64]-<version>” which is created the first time you run the application. There lies all the official Slackware patches QTGZManager downloads from your selected mirror in “Options/Setup/Slackware mirror list”, when you press Ctrl+P. You can have your own mirror appears in that list, as long as you edit the file “~/.config/QTGZManager/mirrors”, putting your URL just as showed in the example there. Please, keep in mind the program will only download the patches, so it’s up to you to create all upgrade actions.

When you’re done with your actions and want to executed them, you just need to press Ctrl+E. If you started QTGZ with a normal user, you’ll be prompted with a tool asking root’s password (probably kdesu). ONLY once you give the Administrator’s password, your created actions will start to execute and output some information in the “Output” tab (next to Actions tab). And as soon as pkgtools does it’s job, a message “Finished executing package actions!” will be generated.

A package action got executed!

After you complete your package action creation, pressing Ctrl+E will execute them.

Last but not least QTGZManager can search your directories for a given package (Ctrl+K). Can search for a file inside a given package (pressing Ctrl+Shift+F while in Pane2 or Pane3 or Ctrl+F while in content file list on Pane4). And  also search for a file inside all installed packages, if the user has Pane3 focused (Ctrl+F).

Package content search

Pressing Ctrl+F inside a package content enables you to search for files inside that package.