• Download Java and install it, if not already done
• Download BilderHerunterlader and install it
• Download and install the extension or plugin for your browser, if available.
• In order to make the program internal updates working, you need to give your user-account full access rights on the program folder.
  This is required under Windows Vista, Windows 7, Linux, MacOS and Windows 2000 / XP (if you are working with limited rights)
• • Windows Vista / 7 / 8 / 10: Rightclick on the BilderHerunterlader-Program-Folder -> Properties -> Security -> Click on Edit -> Choose the user -> Allow Full control -> Click on OK until all Windows are closed.
  • Windows 2000 / XP: First you must deactivate the simple file sharing in the Folder Options. Rightclick on the BilderHerunterlader-Program-Folder -> Properties -> Securtiy -> Choose the user -> Allow Full control -> Click on OK
  • Linux: You can do it over the user-interface or by command line. There are many websites for every linux distribution, which will tell you how exactly you can do that.
  • MacOS: I don't have a Mac and don't know the system at all, so i can't tell how to do it under MacOS.
• Start BilderHerunterlader
• • BilderHerunterlader does not have an .exe-File. There is a BH.jar, that file is like an .exe-File. In normal case you can just double-click the file or the entry in the start-menu and the program should start.
  • There are programs like e.g. Winrar, which might register the .jar-Extension for itself. If so, the .jar-File would be opened by that program instead of starting BilderHerunterlader.
    If this is the case you need to register the extension for Java. Under Windows XP you go to Tools - Folder Options - File Types in the Explorer. Scroll down to the JAR entry. Select that entry and click on Advanced. Select the "open" Action and click on "Edit". For "Application used to perform action" you need to choose the path to Java. Click on Browse and go to the Java-Program-Folder which can normally be found under C:\Program files\Java\jre6\bin. This could differ by the Java-Version and operating system. If you still have Java Version 5, you will find Java under C:\Program files\Java\jre1.5.0_xx\bin (xx stands for any number). Now you choose the javaw.exe in that folder. Now in the text-field, if there is none, add a " at the beginning and at the end. Now add -jar "%1" %* at the end.
    The entry should now look like that: "C:\Program files\Java\jre6\bin\javaw.exe" -jar "%1" %*
    Now close all windows by clicking on OK. Now you should be able the start BilderHerunterlader.
    
    For almost all Windows Versions including XP, Vista and 7 you can also use a programm called jarfix, which should fix the problem automatically for you: http://johann.loefflmann.net/en/software/jarfix/index.html
• On the first start the default settings are used and you should change those to your needs.
  The most important options are:
• • Connection -> Direct Connection / Proxy: If you use a proxy, you must define that, otherwise the program is not working.
  • Connection -> Cookies: Here you must choose your browser, if available, because the download from some websites will not work without cookies.
  • Connection -> User-Agent: Here you should type in the User-Agent of your browser, because otherwise links could not be read out of some websites by using the Opera-Plugin or the Copy-to-Clipboard method.
    Please note: The User-Agent of your browser is often changed when the browser is updated or new plugins/extension are installed. So you would have to change it also in BH.
    To find out the User-Agent of your browser you can surf to http://whatsmyuseragent.com/
  • Folders -> Standard Savepath: Here you must choose a folder, in which you want to download the files.
  • Other -> Updates: Many hosts change their websites from time to time, so that the download with BilderHerunterlader is not working anymore. To fix that, there is a program internal Update-Function which updates BilderHerunterlader and the Rules and Host-Plugins. If the option is activated, the program checks on every start if there are upates. If you don't want that, you can still check for updates manually, in order to do that go to Info -> Update.
• Open a website which contains links to Images / Files in your browser
• • In Firefox: Rightclick -> Download files with BH
  • In Opera: Rightclick -> Download files with BH
  • In the Internet Explorer: Rightclick -> Download files with BH
  • Alternative: Copy the URL of the website into the clipboard (ctrl + c). In order make it working that way, you need to enable the "Clipboard - Check for particular links" option in the settings.
    If nothing happens, click on "Check Clipboard now" on the System-Tray-Icon-Menu or in the menubar.
  • Another alternative: Select the images / links in the browser and drag and drop the selection with the mouse to the program-window.
• Now a new window opens, which shows the available files
• Here you can change the download-directory or let it changed automatically by keywords. You can also select which files are downloaded and which not. And you can define some other things.
  For a detailed description of the possibilities you should read the feature-page:
• Now click on OK and the files are added to the download-queue
• Now click on Start on the download-queue and the files are downloading

Interface

• Appearance
• • Specifies the appearance of the program.
  • This settings is not working on all operating systems.
• Language
• • Specifies the language of the program.
  • Only changed after restart
• Size
• • Specifies the display of the size on downloads.
  • "Automatic adjustment" chooses automatically an appropriate unit
• Progress
• • Defines the display of the progress on downloads.
• Fortschrittanzeige - Show download-speed
• • Defines if the download-speed is displayed in the progress display
• Window - Save size and position
• • Defines if the size and position of the window will be saved.
• Tables - Save column-sizes
• • Defines if column sizes of tables are saved and loaded on next start
• Tables - Save table sorting
• • Defines if sort of tables are saved and loaded on next start

Connection

• Direct Connection / HTTP-Proxy
• • Specifies the way how the program connects to the internet. Under normal conditions no change should be necessary here.
  • Only when you are connected to the internet over a proxyserver, you must change these settings.
• Number of connections
• • Specifies how many images are simultaneously downloaded
  • Be careful with this setting. Webservers permit only a certain number of connections.
  • When you specifie this setting to high then downloads of some images will fail. But you can start the download of failed downloads again.
• Cookies
• • Defines if and from which browser cookies are used
  • At the moment it is only possible to use cookies from PaleMoon, Firefox, Opera and Internet Explorer
  • Cookies are sometimes required by websites, otherwise the download will not work

Folders

• Standard-Savepath
• • Folder on the harddisk, where files are stored.
  • The folder can still be changed in the download-selection or queue
• Standard-Savepath - Remember last used directory
• • The standard savepath is always the last used directory in the Download-Selection
• Sub Directories
• • This option can be used to sort files based on their size into sub folders after the download. If "Subdirectories enabled" is checked, then this will be done.
  • For "Subdirectory" the name of the sub directory is defined and the minimum and maximum filesize is defined. After the download files will be automatically moved to the sub directory if the filesize is in the defined range.

Keywords

• Keyword-Search
• • Specifies how the program is searching for keywords.
  • This setting takes only affect when using the search by title.
  • "Only exact matches"
  • • Only exact matches are accepted.
      Example:
      Keywords: Nora Tschirner; Nori Tschirner
      The program searches for "Nora Tschirner" and "Nori Tschirner".
  • "All matches (Strict)"
  • • Here also the individual words are used for the search.
      But only machtes are accepted, if before or after the word no letter is present.
      Example:
      Keywords: Nora Tschirner; Nori Tschirner
      The program searches for "Nora Tschirner", "Nori Tschirner", "Nora", "Tschirner" und "Nori".
      Before and after the words "Nora", "Tschirner"und "Nori" no letter may present.
  • "All matches"
  • • All matches are accepted.
• Keyword-Search - Don't select link on negative target recognition
• • If in the Downlaod-Selection for a link no keyword was found then the link will not selected for download.
  • This setting takes only affect when using the search by filename.

Download

• Logs - Save Logs
• • Specifies if images which were downloaded are saved in a list. That list is used to check if in the download-selection if you already downloaded an image.
• Downloads - Start downloads automatically
• • Specifies if the download is automatically started when images are added to the download queue.
• Filename
• • Defines which characters are allowed in filenames
• Downloads - Deactivate after x failed attempts
• • Downloads will be automatically deactivated after the defined number of failed attempts has been reached
• Minimum Filesize (Bytes)
• • Defines the minimum filesize. If a file was downloaded, which has a filesize lower than the defined minimum size, then the download will be treatet as a failure.
  • If the value 0 is chosen, then this option is disabled
• Timeout (ms)
• • Defines the timespan in which BH tries to connect. If the timespan is reached, then the download will be treated as a failure
  • This option should not be defined too high, but also not too low. The default setting should be used, unless a problem occurs.
• Sort downloads on programstart
• • Defines if and how downloads are sorted on start of BH
• Notification
• • If this option is enabled, then a notification is displayed when all downloads are complete

Other

• Updates - Check for updates at start
• • Specifies if the program is checking for new versions of the hosts when starting
• Zwischenablage - Auf einzelne Links prüfen
• • Legt fest ob das Programm die Zwischenablage auf Links prüft. Diese Einstellung muss aktiviert werden wenn man einen anderen Browser als Firefox, Opera oder Internet Explorer verwendet, da nur für diese Browser eine Extensions / Plugins zur Verfügung steht. Um diese Funktion zu nutzen, öffnet man eine Seite im Browser, die Links zu Dateien enthält. Nun kopiert man die URL (Adresse) der Seite in die Zwischenablage. Das Programm lädt nun diese Seite herunter und überprüft ob Links zu Dateien auf der Seite vorhanden sind und bietet diese dann zum Download an.
• Target-Folder - Always add title to target folder
• • Adds the title automatically to the target folder
• Rules - Rules have higher priority than hoster-classes
• • If this option is activated then the rules are scanned before the hoster-classes. (On adding links or when finding the direct URL to the image on download)
• Backup - Sicherheitskopie der Datenbanken beim Start erstellen
• • Ist diese Option aktiviert so wird beim Start vom BilderHerunterlader Sicherheitskopien der Datenbanken (Warteschlange, Schlüsselwörter, Logs) erstellt. Bei jedem Start wird die alte Sicherheitskopie überschrieben!
• Defragmentieren - Datenbanken beim Start defragmentieren
• • Treten durch diese Einstellung keine Probleme sollte diese nicht deaktiviert werden
  • Die Einstellung bewirkt, dass die Datenbank-Dateien aufgeräumt werden und auf der Festplatte weniger Platz benötigen
• Minimale Dateigrösse für Defragmentation (Bytes)
• • Da das Defragmentieren einige Zeit in Anspruch nimmt, sollte man eine Minimale Dateigrösse festlegen, aber der defragmentiert wird, damit dies nicht jedesmal gemacht werden muss und vor allem nur dann, wenn es wirklich etwas aufzuräumen gibt. Hier sollte die Standard-Einstellung belassen werden.
• Debug-Level
• • Legt fest was für Fehler, Warnungen oder Informationen der BilderHerunterlader in die Log-Datei (BH.log) schreibt
  • Die Standard-Einstellung (Warn) sollte belassen werden, damit werden Fehler und Warnungen geloggt, die für mich als Entwickler wichtig sind, um vorhandene Probleme zu lösen

Hoster-Plugins

• Einige Hoster-Plugins haben eigene Einstellungen
• Diese sind aber nicht bei den anderen Einstellungen, sondern findet man unter Regeln -> Hoster-Plugins. Dort in der Liste gibt es dann einen Button "Einstellungen" bei den Hoster, die Einstellungen haben.
• Hier eine Beschreibung von Einstellungen, die bei mehreren Hoster vorhanden sind
• • Diesen Hoster deaktivieren
  • • Wird diese Option aktiviert, so werden Links von diesem Hoster nicht mehr erkannt und können nicht mehr heruntergeladen werden. Dies kann z.B. gebrauchen, wenn man Rapidshare-Links lieber mit einem anderen Programm runterladen möchte und die Erkennung im BH dafür abschalten will.
  • Downloads von diesem Hoster immer in folgendem Ordner speichern:
  • • Diese Option dient dazu, Dateien von einem Hoster in einem bestimmten Verzeichnis abzuspeichern, anstatt im Standard-Download-Verzeichnis. Z.B. will man Dateien von Rapidshare in einem extra dafür erstellten Ordner, dann kann man diese Option aktivieren und das Verzeichnis auswählen.
    • Die dazugehörige Option "BH erlauben Unterordner zu erstellen in dem angegebenen Ordner" bestimmt, ob man bei der Download-Auswahl trotz des extra Verzeichnisses noch den Titel als Unterverzeichnis verwenden kann.
    • Wichtig: Ist diese Option aktiviert und man wählt in der Download-Auswahl ein anderes Verzeichnis, so würde dies nicht berücksichtigt. Es sei denn die Option für Unterverzeichnisse wäre aktiviert und es handelt sich wirklich um ein Unterverzeichnis des angegeben Verzeichnisses.
  • Maximale Anzahl Verbindungen
  • • Mit dieser Option kann für Downloads eines Hosters festlegen, wieviele gleichzeitige Downloads es geben darf.
    • Wird bei dieser Einstellung ein grösserer Wert, als für die Einstellung für das ganze Programm gewählt, so gilt immer die Einstellung für das ganze Programm.
    • Diese Option ist nützlich bei Hostern, die z.B. nur ein gleichzeitiger Download zulassen. Im BH würde ohne die Einstellung, dann versucht so viele Verbindungen zu öffnen, wie bei den Einstellungen für das ganze Programm festgelegt. Diese würde, falls der Hoster dann nur eine Verbindung zulässt, dafür sorgen, das nur ein Download wirklich ausgeführt wird, die anderen würden fehlschlagen. Begrenzt man aber mit der Einstellung die Anzahl, so wird BH hintereinander immer einen Download starten und warten bis dieser fertig ist, bevor der nächste Download gestartet wird.
  • Automatisch warten bis nächster Download beginnen kann
  • • Einige Hoster haben einen Traffic-Limit. Z.B. kann man bei einem Hoster nur 100 MB pro Stunde runterladen. Danach muss man eine gewisse Zeit warten. Bei einige Hostern ist BH in der Lage, diese Wartezeit zu erkennen und sie abzuwarten und dann automatisch den Download zu starten.
  • Premium-Account
  • • Einige Hoster bieten gegen Bezahlung Premium-Accounts (Kann je nach Hoster verschieden heissen) an. Für einige Hoster gibt es die Einstellung die Unterstützung für solche Accounts zu aktivieren. Wichtig ist, dass dies nur mit Cookies funktioniert. Möchte man also den Premium-Account im BH nutzen, so muss in den Einstellungen unter Verbindung -> Cookies, der entsprechende Browser ausgewählt werden. Verwendet man einen Browser der nicht unterstützt wird, so müsste man einen der unterstützten Browser bei sich installieren und sich mit dem bei dem entsprechenden Hoster einmal einloggen. Dann sollte der Browser die Cookies abspeichern und BH kann die einlesen.
  • HostDefaultFiles
  • • Dieses Hoster-Plugin ist keinem Hoster zugeordnet, sondern sorgt dafür, dass direkt verlinkte Dateien unabhängig vom Hoster erkannt werden.
    • Content-Type prüfen bei direkt verlinkten Bildern
    • • Diese Option sorgt dafür, dass bei Bilder geprüft wird, ob es sich wirklich um ein Bild handelt. Dies sorgt allerdings dafür, dass der Download viel länger dauert und es kann trotzdem sein, dass es sich bei einer Datei um ein Bild handelt, BH dann dieses aber nicht als solches erkennt. Diese Option sollte man also besser nicht aktivieren und sie wird eventuell in neueren Versionen vom BH gar nicht mehr verfügbar sein.
    • Alle Dateitypen (Alle Links werden akzeptiert, egal ob es wirklich eine Datei ist oder nicht)
    • • Das sagt eigentlich schon alles. Alle Links werden vom BH erkannt und in der Download-Auswahl angezeigt.
    • Dann gibt es Einstellungen um die Erkennung von Bildern, Videos, Audio-Dateien und Archive einzuschalten oder abzuschalten. Unabhängig voneinander.
    • Es gibt noch einen Weg andere Links von diesem Plugin erkennen zu lassen. Dieser ist unter dem Punkt "Direkt verlinkte Bilder" hier beschrieben: