5.2 KiB
Bibliogram
An alternative front-end for Instagram.
Bibliogram works without client-side JavaScript, has no ads or tracking, and doesn't urge you to sign up.
See Bibliogram's features: Wiki:Features
Join the Bibliogram discussion room on Matrix: #bibliogram:matrix.org
See also: Invidious, a front-end for YouTube.
Instances
The official instance is on https://bibliogram.art.
Community instances are listed on the wiki page.
If you only use one computer, you can install Bibliogram on that computer and then access the instance through localhost.
Installing
Select a section and follow the instructions in that section only.
With bibliogram-updater
This is the best method to run Bibliogram on a server. This method will automatically keep Bibliogram up to date, requiring no maintenance after the initial setup.
The updater scripts run in fish. If installing fish isn't possible, please choose a different method.
To clone Bibliogram, install dependencies, and automatically keep it up to date in future, run this in a shell:
wget -O install-bibliogram.sh https://raw.githubusercontent.com/cloudrac3r/bibliogram-updater/master/.clone.sh
bash install-bibliogram.sh
If you want more details, extended documentation, or want to use it without pasting code, please check out the project page: https://github.com/cloudrac3r/bibliogram-updater
With Docker
I have no idea how Docker works. Good luck. You won't be automatically updated to new versions with this.
Discuss the Docker setup in issue #81 and tell me about how I can make it more convenient for you, or even submit a pull request if you know what you want.
Recommended: Clone the repo, then docker-compose up.
Alternatively: docker run -p 10407:10407 -v db:/app/db cloudrac3r/bibliogram.
Manually, if you've run webservers before
This is the best method to run Bibliogram if you're a developer. You won't be automatically updated to new versions with this.
- Install node.js (^12.13.0 suggested)
$ git clone https://github.com/cloudrac3r/bibliogram
If you are currently looking at a fork, be sure to actually install that fork instead!$ cd bibliogram$ npm install --no-optional(for Tor support, omit--no-optional)- Edit
/config.jsto suit your environment $ npm start
Bibliogram is now running on 0.0.0.0:10407.
You must configure website_origin. Read Wiki:Configuring for help.
Manually, if you're new to running webservers
You won't be automatically updated to new versions with this.
Guide: Wiki:Installing
Problems? Wiki:Troubleshooting
You must configure website_origin. Read Wiki:Configuring for help.
With Heroku
Don't deploy Bibliogram on Heroku. It's a really bad idea. Please read about the ephemeral filesystem which the database is stored on, and then read about configuring with environment variables, and then read the rate limit documentation, and then understand that Heroku will never be unblocked because Instagram knows that because its IP address is from a cloud server it's going to be doing bad things. Despite these warnings, you can still deploy on Heroku if you really want to.
Credits & license information
All of Bibliogram's code uses the AGPL 3.0 license. In short, this means that if you make any modifications to the code and then publish the result (e.g. by hosting the result on a webserver), you must publicly distribute your changes and declare that they also use AGPL 3.0.
Site banner by TheFrenchGhosty, CC BY-NC-SA 4.0
Site font is Bariol by atipo foundry, located in /src/site/html/static/fonts. Proprietary license, used with permission. See http://atipofoundry.com/license, section "webfont license".