Espial logo

Espial

  •  0 ratings
In category: Bookmarks and Link Sharing

About Espial

An open-source, web-based bookmarking server.

  •   762  
  •   0  
  •   0  
  •   0  
Github stats:
  •  Commits: N/A  
  •   N/A  
  •   N/A  
  •  Latest commit: N/A  

Deploy this app to RackNerd for $0.99/mo only!

Languages/Platforms/Technologies:
Lincenses:

More about Espial

Espial

Espial is an open-source, web-based bookmarking server.

It allows mutiple accounts, but currently intended for self-host scenarios.

The bookmarks are stored in a sqlite3 database, for ease of deployment & maintenence.

The easist way for logged-in users to add bookmarks, is with the "bookmarklet", found on the Settings page.

Also, see the android app for adding bookmarks via an Android Share intent https://github.com/jonschoning/espial-share-android

demo server

log in — username: demo password: demo

https://esp.ae8.org/u:demo

jpg

Docker Setup

see https://github.com/jonschoning/espial-docker

Server Setup (from source)

  1. Install the Stack executable here:

  2. Build executables

    stack build
  3. Create the database

    stack exec migration -- createdb --conn espial.sqlite3
  4. Create a user

    stack exec migration -- createuser --conn espial.sqlite3 --userName myusername --userPassword myuserpassword
  5. Import a pinboard bookmark file for a user (optional)

    stack exec migration -- importbookmarks --conn espial.sqlite3 --userName myusername --bookmarkFile sample-bookmarks.json
  6. Import a firefox bookmark file for a user (optional)

    stack exec migration -- importfirefoxbookmarks --conn espial.sqlite3 --userName myusername --bookmarkFile firefox-bookmarks.json
  7. Start a production server:

    stack exec espial

Configuration

See config/settings.yml for changing default run-time parameters & environment variables. - config/settings.yml is embedded into the app executable when compiled, so after changing config/settings.yml, run stack build again to apply the new settings. - config/settings.yml values formatted like _env:ENV_VAR_NAME:default_value can be overridden by the specified environment variable. - Example - _env:PORT:3000 - environment variable PORT - default app http port: 3000

SSL: use reverse proxy

Development

Backend

  • Install the yesod command line tool: stack install yesod-bin --install-ghc

  • Start a development server:

    yesod devel

Frontend

  • See purs/ folder

Import Bookmark file format (pinboard compatible format)

see sample-bookmarks.json, which contains a JSON array, each line containing a FileBookmark object.

example:

[ {"href":"http://raganwald.com/2018/02/23/forde.html","description":"Forde's Tenth Rule, or, \"How I Learned to Stop Worrying and \u2764\ufe0f the State Machine\"","extended":"","time":"2018-02-26T22:57:20Z","shared":"yes","toread":"yes","tags":"raganwald"},
, {"href":"http://downloads.haskell.org/~ghc/latest/docs/html/users_guide/flags.html","description":"7.6. Flag reference \u2014 Glasgow Haskell Compiler 8.2.2 User's Guide","extended":"-fprint-expanded-synonyms","time":"2018-02-26T21:52:02Z","shared":"yes","toread":"no","tags":"ghc haskell"},
]

Comments (0)

Please login to join the discussion on this project.

Espial Reviews (0)

Overall Rating

None

based on 0 ratings

Please login to review this project.

No reviews for this project yet.

↑ back to top

RackNerd Medium Rectangle Banner

Popular Projects

FluxBB

in Social Networks and Forums
 41k    0    0    0  

Nextcloud

in File Transfer & Synchronization
 31k    1    1    0  

Dashboard

in Personal Dashboards
 11k    0    0    0  

Libreddit

in Social Networks and Forums
 10k    0    1    0  

Audiobookshelf

in Audio Streaming
 9k    0    1    0  

Libre Translate

in Miscellaneous
 8k    0    0    0  

CasaOS

in Self-hosting Solutions
 8k    0    0    0  

Most Discussed

Nextcloud

in File Transfer & Synchronization
 31k    1    1    0  

Tube Archivist

in Automation
 5k    0    1    0  

OneDev

in Project Management
 3k    0    0    0  

iodine

in Proxy
 3k    0    0    0  

Alf.io

in Booking and Scheduling
 3k    0    0    0  

sysPass

in Password Managers
 2k    0    0    0  

Misskey

in Social Networks and Forums
 3k    0    0    0  
pCloud Lifetime

Top Rated Projects

Gitea

 1 rating
in Project Management

Bagisto

 1 rating
in E-commerce

LinkAce

 1 rating
in Bookmarks and Link Sharing

Pydio

 1 rating
in File Transfer & Synchronization

Audiobookshelf

 1 rating
in Audio Streaming

Nextcloud

 1 rating
in File Transfer & Synchronization

Seafile

 1 rating
in File Transfer & Synchronization

Categories

You May Also Be Interested In

Hackershare logo
Hackershare cover

Hackershare

Social bookmarks website for hackers.

Firefox Account Server logo
Firefox Account Server cover

Firefox Account Server

This allows you to host your own Firefox accounts server.

Omnivore logo
Omnivore cover

Omnivore

Free, open source, read-it-later app for serious readers. …