Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pabluk/bokmarken
A self-hosted shelf for storing links for easy visual reference
https://github.com/pabluk/bokmarken
Last synced: about 6 hours ago
JSON representation
A self-hosted shelf for storing links for easy visual reference
- Host: GitHub
- URL: https://github.com/pabluk/bokmarken
- Owner: pabluk
- License: other
- Created: 2013-12-14T18:23:41.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2024-02-07T20:08:47.000Z (9 months ago)
- Last Synced: 2024-06-15T04:11:28.740Z (5 months ago)
- Language: Python
- Homepage:
- Size: 4.55 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Bokmärken
=========
_A self-hosted shelf for storing links for easy visual reference_.
Bokmärken is a Swedish word, meaning _Bookmarks_ in English.
Bokmärken was heavily inspired by Minne, a linkshelf project of [socketubs](https://github.com/socketubs).
It also includes a REST API to import/export and play with your links.
Screenshots
-----------
A responsive design for every device.
[](bokmarken/static/screenshots/desktop-hi-res.png)
[](bokmarken/static/screenshots/nexus4-hi-res.png)
Installation
------------
On a Debian or Ubuntu system, you need to install the following packages:
```bash
sudo apt-get install libxml2-dev libxslt1-dev
```
and create a `virtualenv`:
```bash
cd ~/
git clone https://github.com/pabluk/bokmarken.git
cd bokmarken
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
edit bokmarken/settings.py # Set SECRET_KEY
python manage.py syncdb --migrate --noinput
python manage.py createsuperuser --username=admin --email=admin@localhost # enter a password for the admin user
python manage.py runserver
```
Open your browser at `http://localhost:8000/` and sign in with your credentials.
By default links are stored in a SQLite3 database. If you want to use another database backend supported by Django,
for example PostgreSQL, you need to install additional packages:
```bash
sudo apt-get install libpq-dev
```
on the already created and activated `virtualenv`:
```bash
pip install psycopg2==2.5.1
```
and finally, add your database settings on `bokmarken/local_settings.py`.
See this [page](https://docs.djangoproject.com/en/dev/ref/settings/#databases) for more details
about database settings on Django.
Contributing
------------
Want to contribute? Great! Bug reports, code and documentation patches are greatly appreciated.
Please file bugs and send pull requests using the [issue tracker](https://github.com/pabluk/bokmarken/issues).
Credits
-------
The image used by default on links without thumbnails is licensed under a Creative Commons license
by [gpoo](http://www.flickr.com/photos/gpoo/9004993292/).
License
-------
Licensed under [AGPL v3](http://www.gnu.org/licenses/agpl-3.0.txt). See [LICENSE](https://raw.github.com/pabluk/bokmarken/master/LICENSE) for details.