Unplugged search 🐧🎙️🔎

Local First search engine for the linux unplugged show.

This project is under development ⚠️

Local First TL;DR

There's no central server. The app runs locally on your machine.

You have control over the app. The server and client work on you local network.

Table of contents

• Setup
• Running the web server
• Usage

Features

• Search by tag
• Search by episode id
• Search by title or partial title
• " " operator to include the exact contents in the search
• Episode discovery (through tags in the results page)
• - Exclude operator
• Faster tag search
• Dockerfile

Setup

Requirements

• Python3 (min ver. 3.10)
  • requests & BeautifulSoup
• Rust (min ver. 1.68)

Indexing

Run the python script at the root of the project:

python index/main.py --range 1 16 --download

Range flag accepts two parameters, from and to.

If you already have the pages, run the following to index the pages:

python index/main.py --range 1 16

Getting help

python index/main.py --help

Running the web server

cargo run --release

Logging debug info

RUST_LOG=unplugged_engine=debug cargo run --release

The web server is listening on http://localhost:3000

Usage

In the input field, search using keywords / episode id / partial titles separated by whitespace.

Example queries:

# searches episodes with ubuntu and "remote desktop" tags
ubuntu "remote desktop"

# searches "docker shocker" and fedora but excludes episodes with nixos or "windows server" tags
"docker shocker" fedora -nixos -"windows server"

# searches episodes with a similar title as "DNF or Die"
"DNF or Die"

# searches for the episode with id 404
404