Installation¶

sudo apt-get install fsniper 

sudo aptitude install fsniper 

mkdir -p ~/.config/fsniper
cp /usr/share/doc/fsniper/examples/example.conf ~/.config/fsniper/config 

Einrichtung¶

Die Konfigurations-Datei besteht aus mehreren verschachtelten Blöcken und ist von einem watch-Block umschlossen. In diesem Block dürfen nun weitere Blöcke für die einzelnen Dateitypen definiert werden. Diese Unterblöcke haben immer folgenden Aufbau:

1. zu überwachender Ordner

2. Optionen

3. Suchmuster / MIME-Typ

4. Anweisung ("handler")

#Beispielkonfiguration:
watch {
    # beobachte Verzeichnis ~/drop
    ~/drop {
        # trifft auf alle MIME-Typen zu, die mit image/ beginnen
        image/* {
            # %% wird ersetzt durch den Dateiname
            handler = echo Bild gefunden: %%
        }
    }
    # beobachte Verzeichnis ~/downloads/musik
    ~/downloads/musik {
	# Option: bezieht alle Unterverzeichnisse mit ein	
	recurse = true
	audio/* {
	    # verschiebt die Datei in den Musikordner
	    handler = mv %% ~/Musik	
	}
    }
}

Einstellungen¶

Fsniper kann nach drei verschiedenen Arten Dateien filtern.

file -ib DATEI 

Handler¶

Der Handler, welcher die gesetzten Anweisungen umsetzt, gibt je nach Ergebnis einen Wert zurück:

• 0 bedeutet, dass der Handler die Operation erfolgreich ausgeführt hat

• 2 bedeutet, dass der Handler mit dem Event prinzipiell umgehen kann, derzeit aber ein Problem besteht

Jeder andere Rückgabewert bedeutet, dass der Handler mit der Anweisung nicht umgehen konnte. Das hat zur Folge, dass der nächste Handler (sofern vorhanden) ausprobiert wird.

Ausnahme Firefox-Downloads¶

Firefox erstellt am Anfang des Downloadvorgangs eine leere Datei mit dem Dateinamen sowie eine dazugehörige Datei mit der Erweiterung .part. Fsniper soll in aller Regel erst aktiv werden, wenn der Download vollständig abgeschlossen ist. Daher darf die Anweisung im Handler erst einen Befehl ausführen, wenn der Inhalt der .part-Datei in die Zieldatei geschrieben wird. Hierzu folgender Eintrag in die Konfigurationsdatei:

watch {
    ~/Downloads {
        *.part {
	    handler = echo ignoring file: %%
        }
        * {
            handler = ~/.config/fsniper/firefox-handler.sh %% 
            handler = mv %% ~/Incoming #Hier der eigentliche Befehl
        }

Das referenzierte Skript firefox-handler.sh wird unter ~/.config/fsniper/ abgelegt:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

#!/bin/bash
# Skript, das Aufrufe auf temporäre Firefox-Dateien verhindert

args="$*"
length=`expr length "$*"`
size=`du "${args}" | awk '{print $1'}`

# Wenn zur Datei eine Datei.part existiert und Firefox dies immer noch herunterlädt
# wird die Datei ignoriert bis der Download abgeschlossen ist
# und in die Zieldatei geschrieben wird.
if [[ -e "${args}.part" && "$size" -eq "0" ]]
then
  exit 0
fi

exit 1

Benutzung¶

Fsniper kann als Prozess im Vordergrund oder als Dienst gestartet werden. Zum Testen der Konfigurationsdatei bietet sich der Aufruf mittels

fsniper --verbose 

an. Der Programmablauf wird in der Datei ~/.config/fsniper/log protokolliert. Zu beachten ist noch, dass nach jeder Konfigurationsänderung Fsniper beendet und nochmal neu gestartet werden muss.

Für den regulären Betrieb von Fsniper benutzt man den Daemon-Modus von fsniper. Dazu wird der Fsniper-Daemon per Autostart zu Beginn der Sitzung gestartet. Hier der Inhalt der fsniper.desktop

[Desktop Entry]
Type=Application
Name=Fsniper
Exec=fsniper --daemon ~/.config/fsniper/config
Hidden=false
Icon=system-run
StartupNotify=false
Terminal=false

Links¶

• Dokumentation

• Letzte Änderungen