https://github.com/sebcode/b

Minimalistic bookmark manager for your own server written in PHP. Bookmarks are stored in a sqlite database.
https://github.com/sebcode/b

bookmarks-manager php self-hosted sqlite

Last synced: about 2 months ago
JSON representation

Minimalistic bookmark manager for your own server written in PHP. Bookmarks are stored in a sqlite database.

• Host: GitHub
• URL: https://github.com/sebcode/b
• Owner: sebcode
• License: mit
• Created: 2011-07-31T15:25:19.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2023-05-22T02:24:59.000Z (over 1 year ago)
• Last Synced: 2024-08-02T05:11:40.682Z (5 months ago)
• Topics: bookmarks-manager, php, self-hosted, sqlite
• Language: PHP
• Homepage:
• Size: 218 KB
• Stars: 52
• Watchers: 10
• Forks: 11
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# b - Bookmark manager

b is a minimalistic bookmark manager for your own server. Written in PHP.

Bookmarks are stored in a sqlite database. Features:

 * filtering

 * tagging

 * automatic fetching of page title

 * infinite scrolling (optional)

 * bookmarklet

 * multiple users

### Requirements

 * make

 * docker + docker compose

Tested on Ubuntu 21.04 and macOS Big Sur.

### Setup

This web app uses HTTP basic auth password protection. Create a `htusers` file

and specify username/password like this:

    mkdir db

    ./htpasswd -c db/htusers peter

The bookmark manager can host multiple databases. To initialize a new database,

simply create a subdirectory:

    mkdir db/peter

This will make bookmarks accessible via `http://localhost:9090/peter`.

Use `make` to start the webserver container and `make down` to stop it.

To prevent forking the container into the background, use `make up` instead of

`make` (useful for debugging).

### How to use

 * To add a new bookmark, simply paste it into the input field and press

   return. the url may be followed by hash tags, e.g. `http://example.com

   #example #bla #wurst`

 * The website's title is automatically fetched and the bookmark is added to

   the database.

 * Edit title by double clicking it. This opens a prompt-dialog where you can

   edit the title. Enter '-' (minus sign) to remove an entry.

 * To edit the URL, double click beside the link.

 * The input field can also be used to filter bookmarks. Filtering is done with

   a full-text search on all titles. Search terms are separated by spaces

   and joined with AND.

### Infinite scrolling

If you have a massive amount of bookmarks and you don't want to load them all at

once, you can activate infinite scrolling. This will load a limited amount of

bookmarks initially and load more when you scroll to the bottom of the page.

Activate infinite scrolling by adding `INFINITE_SCROLLING=200` to `.env`.

Replace `200` with the number of bookmarks you want to load each time you hit

the bottom.

### Bookmarklet

Visit `/[user]/bookmarklet` to access the user's bookmarklet, e.g.

`http://bookmarks.example.com/peter/bookmarklet`. (Thanks to nibreh for the

suggestion!)

### Credits

Copyright (c) 2011-2021 Sebastian Volland http://github.com/sebcode

The source code is licensed under the terms of the MIT license (see LICENSE

file).