Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
Next revisionBoth sides next revision
xfce:thunar:custom-actions [2012/12/04 11:13] – created nickxfce:thunar:custom-actions [2019/11/30 21:58] – added icon and section dividers kevinbowen
Line 1: Line 1:
-====== Custom actions ======+{{ :xfce:thunar:thunar.png?nolink|}} 
 +====== Custom Actions ======
  
-Thunar allows users to add custom actions to the file and folder context menus (by the use of the ''thunar-uca'' plugin, part of the Thunar distribution, in the ''plugins/'' subdirectory). You can setup new actions in the {gui>Custom Actions} dialog, available via the {gui>Configure custom actions...} item in the {gui>Edit} menu.+Thunar allows users to add custom actions to the file and folder context menus (by the use of the ''thunar-uca'' plugin, part of the Thunar distribution, in the ''plugins/'' subdirectory). You can set up new actions in the {gui>Custom Actions} dialog, available via the {gui>Configure custom actions...} item in the {gui>Edit} menu.
  
 This page serves as an introduction to the **Custom Actions** plugin, and includes a list of useful examples. This page serves as an introduction to the **Custom Actions** plugin, and includes a list of useful examples.
  
-===== Adding a custom action =====+---- 
 + 
 +===== Adding a Custom Action =====
  
 This section provides a step-by-step introduction to the **Custom Actions** plugin, demonstrating how to add a **Print File** action, which uses xfprint to print text files. We start by opening the **Custom Actions** dialog as explained above. In the dialog, click on the first button in the list of buttons (the one labeled with the ''+''). The **Create Action** dialog will appear, as shown in the screenshot below. This section provides a step-by-step introduction to the **Custom Actions** plugin, demonstrating how to add a **Print File** action, which uses xfprint to print text files. We start by opening the **Custom Actions** dialog as explained above. In the dialog, click on the first button in the list of buttons (the one labeled with the ''+''). The **Create Action** dialog will appear, as shown in the screenshot below.
  
-On the first page, enter ''Print File'' as name and ''Print the selected using xfprint'' as description. Enter ''xfprint4 %f'' as command (the ''%f'' will be replaced with the path to the selected file, as explained in the dialog), and select an icon for the icon (in the screenshot the ''xfprint.svg'' icon was used). **NB:** Thunar seems to do the sensible thing when passing file/folder names with spaces in them, so don't worry excessively about putting single or double quotes around the "%" placeholder.+<figure "Create Action Dialog"> 
 +{{:xfce:thunar:uca-create.png?nolink&|}} 
 +</figure> 
 + 
 +On the first page, enter ''Search with Catfish'' in {gui>Name:} and ''search'' in {gui>Description:} Enter ''catfish %f'' for the {gui>Command:} (the ''%f'' will be replaced with the path to the selected file, as explained in the dialog), and select an icon by clicking {gui>Icon:} (in the screenshot the ''system-search.svg'' icon was used). <note>Thunar seems to do the sensible thing when passing file/folder names with spaces in them, so don't worry excessively about putting single or double quotes around the "%" placeholder.</note>
  
 Now, continue with the second page (the {gui>Appearance Conditions} page). Now, continue with the second page (the {gui>Appearance Conditions} page).
  
-We want to create an action that is only applicable to text files, so select the **Text Files** options and unselect the options for the other file types. Next you can specify a **File Pattern** to display the action only for text files that match a certain pattern. In the example, we set the file pattern to ''*'' (which matches all filenames) to indicate that the action should be displayed for all text files.+We want to create an action that is only applicable to folders, so select the **Folders** options and unselect the options for the other file types. Next you can specify a **File Pattern** to display the action only for text files that match a certain pattern. In the example, we set the file pattern to ''*'' (which matches all filenames) to indicate that the action should be displayed for all folders.
  
-That's all. Click **OK** to close the **Create Action** dialog. The new action, labeled **Print File** will appear in the **Custom Actions** list.+That's all. Click **OK** to close the **Create Action** dialog. The new action, labeled **Search with Catfish** will appear in the **Custom Actions** list.
  
-Now close the **Custom Actions** dialog, select a text file in Thunar and open the context menu (right-click on the file icon). The newly created **Print File** action will appear in the context menu, as shown in the screenshot below.+Now close the **Custom Actions** dialog, select a folder in Thunar and open the context menu (right-click on the file icon). The newly created **Search with Catfish** action will appear in the context menu, as shown in the screenshot below.
  
-{{ documentation:thunar-custom-actions-3.png }}+<figure "Custom Actions Dialog"> 
 +{{:xfce:thunar:uca-list.png}} 
 +</figure>
  
-You can use the [[http://thunar.xfce.org/pwiki/start#mailinglist|thunar-dev mailinglist]] to get in touch with the developers, if you have questions about this short tutorial or custom actions in general.+[[|Back to Top]] 
 +---- 
 + 
 +===== Use mnemonics to open Thunar Custom Actions ===== 
 + 
 +When you create a Thunar Custom Action you can set the name with an underscore "_" before a letter to use it as mnemonic.  When you right click in a Thunar view, you can type the letter to access your custom action. 
 +----
  
 ===== Examples ===== ===== Examples =====
Line 27: Line 42:
 Here are a few useful examples of custom actions. Feel free to extend this list. Here are a few useful examples of custom actions. Feel free to extend this list.
  
-==== Finding files in the current folder ====+==== Finding files in the current folder with gnome-search-tool ====
     * Name: **Search...**     * Name: **Search...**
     * Command: ''gnome-search-tool --path=%f''     * Command: ''gnome-search-tool --path=%f''
Line 35: Line 50:
 **Note:** For this action, you'll need to have ''gnome-search-tool'' installed, which is part of the ''gnome-utils'' package. This program also has a [[http://linux.die.net/man/1/gnome-search-tool|lot of other nice command-line options]] which you could use to create even more specialized actions. **Note:** For this action, you'll need to have ''gnome-search-tool'' installed, which is part of the ''gnome-utils'' package. This program also has a [[http://linux.die.net/man/1/gnome-search-tool|lot of other nice command-line options]] which you could use to create even more specialized actions.
  
 +----
  
- +==== Finding files inside the current/selected folder with catfish ==== 
- +    * Name: **Search files inside...** 
- +    * Command: ''catfish %f''
- +
-==== Finding files in the current folder with catfish ==== +
-    * Name: **Search files...** +
-    * Command: ''%%catfish --fileman=thunar --path=%f%%''+
     * File pattern: *     * File pattern: *
     * Appears if selection contains: Directories     * Appears if selection contains: Directories
Line 48: Line 60:
 **Note:** For this action, you'll need to have ''catfish'' installed, which is part of the ''catfish'' package. **Note:** For this action, you'll need to have ''catfish'' installed, which is part of the ''catfish'' package.
  
- +----
- +
- +
- +
- +
-==== Finding files inside the selected folder with catfish ==== +
-    * Name: **Search files inside...** +
-    * Command: ''%%catfish --fileman=thunar --path=%f%d%%'' +
-    * File pattern: * +
-    * Appears if selection contains: Directories +
- +
-**Note:** For this action, you'll need to have ''catfish'' installed, which is part of the ''catfish'' package.+
  
 ==== Working with archives  (tar, gzip, etc) ==== ==== Working with archives  (tar, gzip, etc) ====
Line 78: Line 79:
  
 **Hint:** You may prefer the [[http://thunar.xfce.org/plugins.html#thunar-archive-plugin|Thunar Archive Plugin]], which does pretty much the same thing with less manual setup required on your part. It's either included with your distribution (in the case of [[http://xubuntu.org/|Xubuntu]]), or available as a separate package (''thunar-archive-plugin'' in Debian Etch). You might also need the ''xarchiver'' or "squeeze" package for things to work quite right. **Hint:** You may prefer the [[http://thunar.xfce.org/plugins.html#thunar-archive-plugin|Thunar Archive Plugin]], which does pretty much the same thing with less manual setup required on your part. It's either included with your distribution (in the case of [[http://xubuntu.org/|Xubuntu]]), or available as a separate package (''thunar-archive-plugin'' in Debian Etch). You might also need the ''xarchiver'' or "squeeze" package for things to work quite right.
 +
 +----
  
 ==== Playing music files ==== ==== Playing music files ====
Line 84: Line 87:
     * File pattern: *     * File pattern: *
     * Appears if selection contains: Directories, Audio Files     * Appears if selection contains: Directories, Audio Files
- 
     * Name: **Enqueue in XMMS**     * Name: **Enqueue in XMMS**
     * Command: ''xmms -e %F''     * Command: ''xmms -e %F''
Line 91: Line 93:
  
 **Hint:** Works exactly the same with Audacious. **Hint:** Works exactly the same with Audacious.
 +
 +----
  
 ==== Burning an ISO file to a CD ==== ==== Burning an ISO file to a CD ====
Line 97: Line 101:
     * File pattern: *.iso     * File pattern: *.iso
     * Appears if selection contains: Other Files     * Appears if selection contains: Other Files
 +
 +----
  
 ==== Viewing images ==== ==== Viewing images ====
Line 105: Line 111:
 **Note:** This tip also works just as well with GThumb **Note:** This tip also works just as well with GThumb
  
 +----
  
 ==== Converting PNGs to JPEGs ==== ==== Converting PNGs to JPEGs ====
Line 114: Line 121:
 **Hint:** ''`basename %f .png`.jpg'' (be careful--those are //back//ticks) will strip the old .png extension off of the original filename. **Hint:** ''`basename %f .png`.jpg'' (be careful--those are //back//ticks) will strip the old .png extension off of the original filename.
  
 +----
  
 ==== Losslessly Rotating JPEGs ==== ==== Losslessly Rotating JPEGs ====
Line 122: Line 129:
     * Appears if selection contains: JPEG Image Files     * Appears if selection contains: JPEG Image Files
 **Note:** jpegtran is available as part of the libjpeg or libjpeg-progs packages of most distributions. Unlike using "convert", the complicated loop structure is necessary with "jpegtran": "jpegtran -rotate 90 -outfile %F %F" will produce a 0kb file. **Note:** jpegtran is available as part of the libjpeg or libjpeg-progs packages of most distributions. Unlike using "convert", the complicated loop structure is necessary with "jpegtran": "jpegtran -rotate 90 -outfile %F %F" will produce a 0kb file.
 +
 +[[https://thelinuxchronicles.blogspot.com/2012/06/thunar-custom-actions-resize-and-rotate.html|Here an example]] how rotation can be scripted with "convert".
 +
 +----
  
 ==== Opening a terminal ==== ==== Opening a terminal ====
Line 130: Line 141:
  
 **Note:** You might need to type ''xfce4-terminal'' instead of just ''terminal'' for some distributions. **Note:** You might need to type ''xfce4-terminal'' instead of just ''terminal'' for some distributions.
 +
 +----
  
 ==== Opening a root terminal ==== ==== Opening a root terminal ====
Line 138: Line 151:
  
 **Note:** You should rewrite the command with normal straight quotes. **Note:** You should rewrite the command with normal straight quotes.
 +
 +----
  
 ==== Opening a root Thunar ==== ==== Opening a root Thunar ====
Line 144: Line 159:
     * File pattern: *     * File pattern: *
     * Appears if selection contains: Directories     * Appears if selection contains: Directories
 +
 +**Note:** Some distributions no longer include ''gksu''. Use ''pkexec'' instead.
 +
 +----
  
 ==== Editing as root ==== ==== Editing as root ====
Line 151: Line 170:
     * Appears if selection contains: Text files     * Appears if selection contains: Text files
  
-**Note:** You'll need to replace put-your-favourite-text-editor-here with your favourite text editor (e.g. mousepad or geany).+**Note:** You'll need to replace put-your-favourite-text-editor-here with your favourite text editor (e.g. mousepad or geany). Also, see previous note about ''gksu''. 
 + 
 +----
  
 ==== Creating a symbolic link ==== ==== Creating a symbolic link ====
Line 167: Line 188:
     * Appears if selection contains: //any//     * Appears if selection contains: //any//
  
 +----
  
 ==== Setting an image as the desktop background ==== ==== Setting an image as the desktop background ====
Line 174: Line 195:
     * File pattern: *     * File pattern: *
     * Appears if selection contains: Image Files     * Appears if selection contains: Image Files
 +
 +----
  
 ==== Viewing the disk usage of the current directory ==== ==== Viewing the disk usage of the current directory ====
Line 183: Line 206:
 **Note:** The idea is to get a visual picture of the current directory and any subdirectories. You could also use fsview or filelight, but the visuals are crisper in baobab. **Note:** The idea is to get a visual picture of the current directory and any subdirectories. You could also use fsview or filelight, but the visuals are crisper in baobab.
  
-==== Using 'nano' text editor ==== +---- 
-    * Command: ''terminal -x nano %f''+ 
 +==== Using 'nano' text editor in a terminal ==== 
 +    * Name: **Open in Terminal** 
 +    * Command: xfce4-terminal -x nano %f 
 +    *  File pattern: * 
 +    * Appearance Conditions: Text files 
  
 Since nano isn't a GUI app, you must start it in a terminal window. Since nano isn't a GUI app, you must start it in a terminal window.
 +
 +----
  
 ==== Comparing selected files/directories ==== ==== Comparing selected files/directories ====
Line 194: Line 225:
     * Appears if selection contains: Directories and Text files     * Appears if selection contains: Directories and Text files
  
-**Note:** You will need ''meld'' package.+**Note:** You will need the ''meld'' package. 
 + 
 +----
  
-==== Changing OpenOffice.org supported formats ====+==== Changing OpenDocument-supported formats ====
 **Note:** You will need ''unoconv'' package for all following actions. **Note:** You will need ''unoconv'' package for all following actions.
  
Line 210: Line 243:
  
 You can go on, try ''man unoconv'' for details. You can go on, try ''man unoconv'' for details.
 +
 +----
 +
 ==== Download subtitles with periscope ==== ==== Download subtitles with periscope ====
     * Name: **Download subtitles**     * Name: **Download subtitles**
Line 216: Line 252:
     * Appears if selection contains: Video Files     * Appears if selection contains: Video Files
  
-**Note:** You will need ''python-periscope'' package. Get it [[http://code.google.com/p/periscope/|here]]. You'll also neeed ''zenity'' package. This command will try to get the English subtitles, change ''-l en'' to something else (''fr'', ''de'', ''pt-br'', ...). You should rewrite the command with normal straight quotes.+**Note:** You will need ''python-periscope'' package. Get it [[http://code.google.com/p/periscope/|here]]. You'll also need ''zenity'' package. This command will try to get the English subtitles, change ''-l en'' to something else (''fr'', ''de'', ''pt-br'', ...). You should rewrite the command with normal straight quotes. 
 + 
 +---- 
 ==== Rename subtitles easily ==== ==== Rename subtitles easily ====
     * Name: **Rename subtitles**     * Name: **Rename subtitles**
Line 224: Line 263:
     * Appears if selection contains: Video Files, Text Files, Other Files     * Appears if selection contains: Video Files, Text Files, Other Files
  
-**Note:** You will need ''subrnm'' script. Get it [[http://pastebin.com/DA8jwHz3|here]]. You'll also neeed ''zenity'' package.+**Note:** You will need ''subrnm'' script. Get it [[http://pastebin.com/DA8jwHz3|here]]. You'll also need ''zenity'' package.
  
-==== Resize and email images ==== +---- 
-     * Name: **Resize Images then email them** + 
-     * Description: Select Image files and resize them before sending in email. Leaves originals untouched. +==== Move files into a new folder ==== 
-     * File pattern: * +    * Name: **Move into new folder** 
-     * Appears if selection contains: Image files +    * Description: Select any number of file/folders. A dialog will popup in which you can write the name of a new folder to create. Selected Files will be moved there. 
-** Note:** You will need the script here (which I name thunar-resize-sendto and place in /usr/local/bin), "zenity", and "imagemagick" packages. I used the xfce-newmail icon. Use the following command line:\\ +    * Command: NEW_FOLDER=$(/usr/bin/zenity --entry --title "Move into new folder" --text "Please enter a name for the new folder"); mkdir $NEW_FOLDER; mv %F $NEW_FOLDER  
-/usr/local/bin/thunar-resize-sendto %F\\ +    * File pattern: * 
-\\ +    * Appears if selection contains: All
-Not sure why this isn't part of Thunar plugins, since it's pretty sweet. Tested on Xubuntu Lucid.\\ +
-\\ +
-**NOTE!:** This uses /tmp/thunar-pics0 & /tmp/thunar-pics1 as temp directories, and will completely remove anything in these directories.  I doubt there's a conflict, but you've been warned.  You can see the list of files it creates below in /tmp.+
  
-<code> +**Note:** You'll will need the ''zenity'' package.
-#!/bin/bash +
-#input to this is a list of files to send. +
-# depends on thunar, ImageMagick and Zenity +
-TMP=/tmp/thunar-pics +
-LOG=/tmp/thunar-resize-sendto.log +
-MARKER=/tmp/thunar-resize-sendto.marker +
-SENDTO="/usr/lib/thunar/thunar-sendto-email" +
-SIZES="320x200 640x480 800x600 1024x640" +
-DISCMD="zenity --list --text=\"Select Size\" --checklist --column=Select --column=New --hide-header --print-column=ALL" +
-# Find unused tmp dir +
-if [ -e $MARKER ]; then +
-  CUR=$(cat $MARKER) +
-else +
-  CUR=1 +
-fi +
-if [ 1 == $CUR ]; then +
-  CUR=0 +
-else +
-  CUR=1 +
-fi +
-echo "$CUR" >$MARKER +
-TEMP="${TMP}$CUR" +
-mkdir -p $TEMP +
-rm -rf $TEMP/*+
  
-for s in $SIZES; do 
-  if [ -z $COLS ]; then  
-    COLS="$s " 
-  else 
-    COLS="$COLS 0 $s" 
-  fi 
-done 
-SIZE=$($DISCMD $COLS) 
-echo "CUR=$CUR SIZE=$SIZE" >$LOG 
  
-for f in "$@"; do +[[|Back To Top]] 
-  n=$(basename "$f")  +---- 
-  echo "item '$f'->$TEMP/$n" >>$LOG +[[:xfce:thunar:|Back to Thunar documentation page]]
-  convert $f -resize $SIZE "$TEMP/$n" +
-  FILES="$FILES $TEMP/$n" +
-done +
-$SENDTO $FILES +
-</code>+