Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rix1337/FeedCrawler
FeedCrawler automatisiert bequem das Hinzufügen von Links für den JDownloader.
https://github.com/rix1337/FeedCrawler
automation download feedcrawler jdownloader rsscrawler
Last synced: about 2 months ago
JSON representation
FeedCrawler automatisiert bequem das Hinzufügen von Links für den JDownloader.
- Host: GitHub
- URL: https://github.com/rix1337/FeedCrawler
- Owner: rix1337
- License: mit
- Created: 2016-03-14T16:27:34.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-07-27T11:23:10.000Z (about 2 months ago)
- Last Synced: 2024-07-28T11:32:35.066Z (about 2 months ago)
- Topics: automation, download, feedcrawler, jdownloader, rsscrawler
- Language: Python
- Homepage:
- Size: 5.5 MB
- Stars: 76
- Watchers: 15
- Forks: 16
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# FeedCrawler
FeedCrawler automatisiert bequem das Hinzufügen von Links für den JDownloader.
[](https://github.com/rix1337/FeedCrawler/actions/workflows/CreateRelease.yml)
[](https://github.com/rix1337/FeedCrawler/stargazers)
[](https://github.com/rix1337/FeedCrawler/releases)
[](https://pypi.org/project/feedcrawler/)
[](https://pypi.org/project/feedcrawler/#files)
[](https://hub.docker.com/r/rix1337/docker-feedcrawler/tags)
[](https://hub.docker.com/r/rix1337/docker-feedcrawler/)
[](https://github.com/rix1337/FeedCrawler/blob/main/LICENSE.md)
[](https://github.com/rix1337/FeedCrawler/tree/main/feedcrawler)
[](https://github.com/rix1337/FeedCrawler/tree/main/feedcrawler/web_interface/vuejs_frontend)
[](https://github.com/rix1337/FeedCrawler/commits/main)
[](https://github.com/rix1337/FeedCrawler/graphs/commit-activity)
[](https://github.com/rix1337/FeedCrawler/pulse)
[](https://github.com/users/rix1337/sponsorship)
[](https://discord.gg/enn4AG3VnM)
[](https://github.com/rix1337/FeedCrawler/issues)
***
## Installation
## Manuelle Installation
### Voraussetzungen
* [Python 3.8](https://www.python.org/downloads/) oder neuer (nur
4 [externe Abhängigkeiten](https://github.com/rix1337/FeedCrawler/blob/main/requirements.txt)!)
* [JDownloader 2](http://www.jdownloader.org/jdownloader2) mit
aktivem [My JDownloader-Konto](https://my.jdownloader.org)
* _optional: [FlareSolverr 3](https://github.com/FlareSolverr/FlareSolverr) um Cloudflare-Blockaden zu umgehen_
### Installation / Update durch [pip](https://pip.pypa.io/en/stable/installation/)
```pip install -U feedcrawler```
### Lokaler Build
Benötigt [Node.js](https://nodejs.org/en/download/), [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
und [pip](https://pip.pypa.io/en/stable/installation/):
1. Frontend-Pfad aufrufen: `cd feedcrawler/web_interface/vuejs_frontend`
2. Dependencies installieren: `npm ci`
3. [Vue.js 3](https://vuejs.org/) Frontend kompilieren: `npm run build`
4. Zurück in das Hauptverzeichnis wechseln: `cd ../../..`
5. FeedCrawler auf Basis der _setup.py_ installieren: `pip install .`
### Start
```feedcrawler``` in der Konsole (Python muss im System-PATH hinterlegt sein)
### [Docker Image](https://hub.docker.com/r/rix1337/docker-feedcrawler/)
```
docker run -d \
--name="FeedCrawler" \
-p port:9090 \
-v /path/to/config/:/config:rw \
-e DELAY=30 \
-e LOGLEVEL=[INFO/DEBUG] \
--log-opt max-size=50m \
rix1337/docker-feedcrawler
```
* Der Betrieb als Docker-Container empfiehlt sich als Standardinstallation - vor allem für NAS-Systeme, Homeserver und
sonstige Geräte die dauerhaft und möglichst wartungsfrei (headless) betrieben werden sollen.
* Bei jedem Release wird ein getaggtes Image erstellt. Damit kann man auf der Wunschversion verbleiben oder im Falle
eines Bugs zu einer stabilen Version zurück kehren.
* Um immer auf dem aktuellen Stand zu sein, einfach das mit `latest` getaggte Image nutzen.
* Für UNRAID-Server kann das Image direkt über die Community Applications bezogen und der Container so eingerichtet
werden.
##### Spezifische Version nutzen
Das Image `rix1377/docker-feedcrawler` wird standardmäßig auf das `:latest`-Tag aufgelöst. Dieses wird mit jedem Release
auf die neue Version aktualisiert. Mit jedem Release wird ebenfalls eine getaggte Version des Images erzeugt. Auf
letztere kann man wechseln, um beispielsweise bei Fehlern in der neuen Version auf einen funktionierenden Stand zurück
zu kehren.
Beispiel:
`docker pull rix1337/docker-feedcrawler:13.3.7`
### Windows Build
* Jedem [Release](https://github.com/rix1337/FeedCrawler/releases) wird eine selbstständig unter Windows lauffähige
Version des FeedCrawlers beigefügt.
* Hierfür müssen weder Python, noch die Zusatzpakete installiert werden.
* Einfach die jeweilige Exe herunterladen und ausführen bzw. bei Updates die Exe ersetzen.
## Hostnamen
FeedCrawler kann zum Durchsuchen beliebiger Webseiten verwendet werden.
Welche das sind, entscheiden Anwender selbständig bei der Einrichtung. Es gilt dabei:
* Welche Hostname aufgerufen werden entscheidet allein der Anwender.
* Ist nicht mindestens ein Hostname gesetzt, wird der FeedCrawler nicht starten.
* Passen Hostnamen nicht zum jeweiligen Suchmuster des FeedCrawlers, sind Fehlermeldungen möglich.
## Startparameter
| Parameter | Erläuterung |
|------------------------------|--------------------------------------------------------------------|
| ```--log-level=``` | Legt fest, wie genau geloggt wird (`INFO` oder `DEBUG`) |
| ```--port=``` | Legt den Port des Webservers fest |
| ```--delay=``` | Verzögere Suchlauf nach Start um ganze Zahl in Sekunden (optional) |
## Sicherheitshinweis
Der Webserver sollte nie ohne Absicherung im Internet freigegeben werden. Dazu lassen sich im Webinterface Nutzername
und Passwort festlegen.
Es empfiehlt sich, zusätzlich einen Reverse-Proxy mit HTTPs-Zertifikat,
bspw. [kostenlos von letsencrypt](https://letsencrypt.org/), zu verwenden.
## Credits
* [mmarquezs](https://github.com/mmarquezs/) (My-JDownloader-API für Python)