Skip to content

Latest commit

 

History

History
192 lines (159 loc) · 11.8 KB

README.md

File metadata and controls

192 lines (159 loc) · 11.8 KB

Linkding Sync

LinkdingSync is a collection of tools that make life with Linkding easier.

One of the workers is for syncing to Wallabag.

Getting Started

It is recommended to use the Docker images. Otherwise, a .NET 8 environment is required to customize and build the code.

Environment Variables

For the containers to work, the environment variables must be passed. This can be done either directly via the Docker run -e switch, via the environment settings in a Docker compose definition, or via an environment variable file.

WallabagSync

Environment variables for the wallabag worker.

Variable Value Description Attention
Worker__Interval int (>=0) This value sets the execution schedule in minutes. 1 = every minute, 10 = every 10 minutes (default value 0) 0 = runs only one time. The container will be stopped after the execution. This method is the preferred way to run the container with a scheduler (e.g. cron)
Worker__SyncTag text The linkding tag to create the bookmarks in Wallabag. (default value 'readlater')
Linkding__Url text URL to the linkding instance
Linkding__Key text The linkding application key Instructions
Wallabag__Url text URL to the Wallabag instance
Wallabag__Username text Wallabag User Name
Wallabag__Password text Wallabag User Password
Wallabag__ClientId text Wallabag Client Id
Wallabag__ClientSecret text Wallabag Client Secret

LinkdingUpdater

Environment variables for the linkding worker.

Variable Value Description Attention
Worker__Interval int (>=0) This value sets the execution schedule in minutes. 1 = every minute, 10 = every 10 minutes 0 = runs only one time. The container will be stopped after the execution. This method is the preferred way to run the container with a scheduler (e.g. cron)
Worker__Worker__TagNameLength int The max tag name length. Default is 64 characters
Worker__Tasks__X text The tasks which should be executed. X is the array index for the tasks entry currently supported tasks: AddPopularSitesAsTag,AddYearToBookmark.
Linkding__Url text URL to the linkding instance
Linkding__Key text The linkding application key Instructions

Tasks

Tasks define the logic that directly make changes to the bookmarks. Currently available tasks:

Name Description
AddYearToBookmark If the bookmark does not have the year of the creation date as a tag, it will be added.
AddPopularSitesAsTag This is the task for dynamic creation of tags. For this task to work, the rules must be passed to the container as configuration.

The tasks are defined as environment variables, if no tasks are defined, the container will be executed but no changes will be made. The tasks are passed as follows:

version: '3.9'

services:
  linkdingupdater:
    image: ghcr.io/spaytac/linkding-updater:latest
    volumes:
      - ./config.yml:/app/data/config.yml
    # env_file:
    #   - .env
    environment:
      - Worker__Interval=0
      - Worker__TagNameLength=64
      - Worker__Tasks__0=AddPopularSitesAsTag
      - Worker__Tasks__1=AddYearToBookmark
      - Linkding__Url=https://<url>
      - Linkding__Key=<secret>

Configuration

The following explains the configuration options. The Configuration file must be mapped to /app/data/config.yml

WallabagSync

The configuration is optional. In the configuration (YAML File) rules can be defined in regex to exclude certain domains from sync.

Exampel:

excludedDomains:
  - name: youtube
    pattern: 'https://[[a-zA-Z0-9]+\.]?(youtube)\.com(?:/.*)?'
  - name: ebay
    pattern: 'https://[[a-zA-Z0-9]+\.]?(ebay)\.(com|de|fr)(?:/.*)?'
  - name: amazon
    pattern: 'https://[[a-zA-Z0-9]+\.]?(amazon)\.(com|de|fr)(?:/.*)?'

With this configuration every matching bookmark from linkding will be excluded from the sync.

LinkdingUpdater

The configuration is optional. In the configuration (YAML File) rules can be defined in regex to assign tags dynamically. Additionally tags can be defined to domains.

If operated without a configuration file, only the year of the tag is added (currently).

Example:

urlTagMapping:
  - name: microsoft_azure
    url: https://github.com/azure
  - name: microsoft_azuread
    url: https://github.com/AzureAD
  - name: microsoft_dotnet
    url: https://github.com/dotnet-architecture

taggingRule:
  - name: reddit
    pattern: https://(?:www\.)?(reddit)\.com(?:/r/)?([a-zA-Z0-9\-\+_]+)?(?:/.*)?
    replace: $1,$2
  - name: microsoft
    pattern: https://([a-zA-Z0-9]+)?[\.]?(microsoft)\.com(?:/.*)?
    replace: $1,$2
  - name: microsoft_docs
    pattern: 'https://(?:docs)\.(?:microsoft)\.com[/]?(?: [a-zA-Z0-9\-\+_]+)(?:/)?([a-zA-Z0-9\-\+_]+)?(?:/)?([a-zA-Z0-9\-\+_]+)?(?:/.*)?'
    replace: $1,$2
  - name: youtube
    pattern: https://[[a-zA-Z0-9]+\.]?(youtube)\.com(?:/.*)?
    replace: $1
  - name: ebay
    pattern: https://[[a-zA-Z0-9]+\.]?(ebay)\.(com|de|fr)(?:/.*)?
    replace: $1
  - name: amazon
    pattern: https://[[a-zA-Z0-9]+\.]?(amazon)\.(com|de|fr)(?:/.*)?
    replace: $1
  - name: docker
    pattern: https://([a-zA-Z0-9]+)?[\.]?(docker)\.com(?:/.*)?
    replace: $1,$2
  - name: xbox
    pattern: https://[[a-zA-Z0-9]+\.]?(xbox)\.com(?:/.*)?
    replace: $1
  - name: github
    pattern: https://([a-zA-Z0-9]+)?[\.]?(github)\.com[/]?([a-zA-Z0-9\-\+_]+)(?:/)?([a-zA-Z0-9\-\+_]+)?(?:/.*)?
    replace: $1,$2,$3,$4
  - name: github.io
    pattern: https://([a-zA-Z0-9]+)\.(github)\.io[/]?([a-zA-Z0-9\-\+_]+)(?:/)?([a-zA-Z0-9\-\+_]+)?(?:/.*)?
    replace: $1,$2,$3

urlTagMapping

If the bookmark should match one - or more - of the urlTagMappings, then value of name is added as tag to this bookmark.

Example: https://github.com/azure/something will be tagged with microsoft_azure

taggingRule

Dynamic tags can be assigned to the bookmarks on the basis of the URL using regular expression. If one of the patterns matches, the values of the groups are added to the bookmark as a tag.

Example: Here is an example using a reddit bookmark. Url:

https://www.reddit.com/r/selfhosted/comments/yzq6qp/running_a_mostly_sbcbased_nomad_cluster_in_my/?utm_source=share&utm_medium=android_app&utm_name=androidcss&utm_term=2&utm_content=share_button

Pattern:

https://(?:www\.)?(reddit)\.com(?:/r/)?([a-zA-Z0-9\-\+_]+)?(?:/.*)?

Matches:

if you would change the pattern to the following. Pattern:

https://(?:www\.)?(reddit)\.com(?:/)?(r/[a-zA-Z0-9\-\+_]+)?(?:/.*)?

then the following would match.

Docker Run

docker run --rm -it --env-file .env -v <path>/config.yml:/app/data/config.yml ghcr.io/spaytac/linkding-updater:latest
docker run --rm -it --env-file .env -v <path>/config.yml:/app/data/config.yml ghcr.io/spaytac/wallabag-sync:latest

Docker Compose

You can find examples in the examples folder..

Build Docker Images

LinkdingUpdater

docker build -t linkdingsync/linkding-updater:latest -f .\Dockerfile_Linkding .

WallabagSync

docker build -t linkdingsync/wallabag-sync:latest -f .\Dockerfile_Wallabag .