linkwallet/README.md

68 lines
1.9 KiB
Markdown

# linkwallet
A self-hosted bookmark database with full-text page content search.
# Feature list
* Simple cross-platform single binary deployment
* or docker if you prefer
* Bookmarklet, single click to add a bookmark from any webpage
* Full-text search
* Bookmark content is scraped and indexed locally
* Page content periodically refreshed automatically
* Interactively search across titles and content
* Rippingly fast results, as you type
* full text search ~60ms (over full text content of 600 bookmarks)
* No need to remember how you filed something, you just need a keyword
or two to discover it again
* Embedded database, no separate database required
* Light on resources
* ~21Mb binary
* ~40Mb memory
* ~24Mb database (600 bookmarks, full text content indexed)
* Easily export your bookmarks to a plain text file - your data is yours
# Installation
## Docker
* Copy the docker-compose.yml-sample to a directory somewhere
* Rename to docker-compose.yml and edit to your needs
* Run `docker-compose up -d`
## Binary
* Download the appropriate binary from the releases page
* Install somewhere on your system
* Run ./linkwallet -db-path xxxx.db where xxxx.db is the location
of your bookmarks database (will be created if it does not exist)
## Source
* Checkout the code
* `go build cmd/linkwallet/linkwallet.go`
## deb/rpm packages
Coming soon.
# Using
linkwallet is a 100% web-driven app. After running, hit the web interface
on port 8109 (docker using the sample docker-compose.yml) or 8080 (default
on binary).
Change the port number by setting the PORT environment variable.
If you put linkwallet on a separate machine, or behind a reverse proxy,
go into the config page and set the correct BaseURL, or the bookmarklets
will not work.
# Roadmap
* More options when managing links
* delete
* sorting
* More tag options
* search for tags
* bookmarklet with pre-filled tags