{"id":13556981,"url":"https://github.com/mkucej/i-librarian","last_synced_at":"2025-12-16T18:41:49.783Z","repository":{"id":19290278,"uuid":"22527396","full_name":"mkucej/i-librarian","owner":"mkucej","description":"Legacy I, Librarian - collaborative PDF manager. Not maintained, new version is at https://github.com/mkucej/i-librarian-free","archived":true,"fork":false,"pushed_at":"2022-11-13T21:55:36.000Z","size":11757,"stargazers_count":98,"open_issues_count":23,"forks_count":38,"subscribers_count":23,"default_branch":"master","last_synced_at":"2024-11-04T06:35:30.308Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://i-librarian.net","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mkucej.png","metadata":{"files":{"readme":"README.md","changelog":"history.php","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":"citationstyles.php","codeowners":null,"security":null,"support":null}},"created_at":"2014-08-01T20:35:50.000Z","updated_at":"2024-07-07T03:14:53.000Z","dependencies_parsed_at":"2023-01-11T20:36:59.527Z","dependency_job_id":null,"html_url":"https://github.com/mkucej/i-librarian","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkucej%2Fi-librarian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkucej%2Fi-librarian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkucej%2Fi-librarian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkucej%2Fi-librarian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mkucej","download_url":"https://codeload.github.com/mkucej/i-librarian/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246992710,"owners_count":20865868,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T12:04:06.521Z","updated_at":"2025-12-16T18:41:44.730Z","avatar_url":"https://github.com/mkucej.png","language":"PHP","funding_links":[],"categories":["PHP","others"],"sub_categories":[],"readme":"# I, Librarian Instructions\n## Contents\n  - Automated installation using installers\n  - Windows manual installation\n  - Linux manual installation\n  - Mac OS X manual installation\n  - First use\n  - Un-installation\n\n### Automated installation using installers\nYou can download and execute installers for Windows Vista, 7, 8, and 10 plus a DEB\npackage and a console installer for Ubuntu, Debian, and its derivatives. An installer\nfor Mac OS X is not available. These installers will install and/or configure Apache\nand PHP for you. If you don't want that, follow the instructions below to install manually.\n\n### Windows manual installation\n**Before you start, disable Microsoft IIS, close Skype or any other software using port 80.**\n  * Install *Apache 2.4+* and *PHP 5.5+* using a Windows installer like WAMPServer.\n  * Edit Apache configuration file (httpd.conf). Append this at the end using Notepad:\n\n```apache_conf\nAlias /librarian \"C:\\I, Librarian\"\n\u003cDirectory \"C:\\I, Librarian\"\u003e\n    AllowOverride None\n    # Allow access from this computer\n    Require local\n    # Allow access from intranet computers\n    Require ip 10\n    Require ip 172.16 172.17 172.18 172.19 172.20\n    Require ip 172.21 172.22 172.23 172.24 172.25\n    Require ip 172.26 172.27 172.28 172.29 172.30 172.31\n    Require ip 192.168\n    # Insert Allow from directives here to allow access from the internet\n    # \"Require all granted\" opens access to everybody\n    \u003cIfModule mod_php5.c\u003e\n        php_value upload_max_filesize 400M\n        php_value post_max_size 800M\n    \u003c/IfModule\u003e\n    \u003cFilesMatch \"\\.(ini|conf)$\"\u003e\n        Require all denied\n    \u003c/FilesMatch\u003e\n\u003c/Directory\u003e\n\u003cDirectory \"C:\\I, Librarian\\library\"\u003e\n    Require all denied\n\u003c/Directory\u003e\n```\n\nYou may wish to alter who has access (e.g. to allow access from more IP numbers or domain names) - see the Apache [Authentication and Authorization HOWTO](https://httpd.apache.org/docs/2.4/howto/auth.html) for details.\n\n  * You may change `C:\\I, Librarian` to any directory where you want to have *I, Librarian*,\n    including an external drive. For a groupware use, you need to allow access to more IP\n    numbers or domain names.\n  * Restart the server.\n  * Unzip I, Librarian files into the directory defined by `Alias` in `httpd.conf`.\n\n### Linux manual installation\n* If you did not use the DEB package, make sure you have installed these packages from repositories:\n  - **apache2 (may be named httpd)**: a web server (you may run *I, Librarian* with a different web server).\n  - **php5 (may be named php)**: *I, Librarian* requires PHP5.4.\n  - **php5-sqlite (may be named php-pdo)**: SQLite database for PHP5.\n  - **php5-gd (may be named php-gd)**: GD library for PHP5.\n  - **php5-curl (may be named php-curl)**: curl library for PHP5.\n  - **poppler-utils**: required for PDF indexing and for the built-in PDF viewer.\n  - **ghostscript**: required for the built-in PDF viewer.\n  - **tesseract-ocr**: required for OCR.\n  - **libreoffice**: required for conversion of office files to PDF.\n* If you are installing from the tar.gz, login as `root` or use `sudo`, and extract files\n  into 'librarian' directory in your web sever's root directory. Example:\n\n```bash\n  tar zxf I,-Librarian-*.tar.gz -C /var/www/html/librarian\n```\n* Change the owner of the library sub-folder to Apache. Example:\n\n```bash\n  chown -R apache:apache /var/www/html/librarian/library\n  chown root:root /var/www/html/librarian/library/.htaccess\n```\n* Insert a safe setting like this example into your Apache configuration file:\n\n```apache_conf\n\u003cDirectory \"/var/www/html/librarian\"\u003e\n    AllowOverride None\n    # Allow access from this computer\n    Require local\n    # Allow access from intranet computers\n    Require ip 10\n    Require ip 172.16 172.17 172.18 172.19 172.20\n    Require ip 172.21 172.22 172.23 172.24 172.25\n    Require ip 172.26 172.27 172.28 172.29 172.30 172.31\n    Require ip 192.168\n    # Insert Allow from directives here to allow access from the internet\n    # \"Require all granted\" opens access to everybody\n    \u003cIfModule mod_php5.c\u003e\n        php_value upload_max_filesize 400M\n        php_value post_max_size 800M\n    \u003c/IfModule\u003e\n    \u003cFilesMatch \"\\.(ini|conf)$\"\u003e\n        Require all denied\n    \u003c/FilesMatch\u003e\n\u003c/Directory\u003e\n\u003cDirectory \"/var/www/html/librarian/library\"\u003e\n    Require all denied\n\u003c/Directory\u003e\n```\nYou may wish to alter who has access (e.g. to allow access from more IP numbers or domain names) - see the Apache [Authentication and Authorization HOWTO](https://httpd.apache.org/docs/2.4/howto/auth.html) for details.\n\n* Restart the server.\n\n### Mac OS X manual installation\n\nYou will need to have an Apache + PHP stack installed. Details may vary depending on which PHP stack you are using.\n\nPrior to Mac OS 10.10.1 (Yosemite), the default install of Mac OS included Apache and PHP built with the GD library. However, the PHP installed with     Yosemite does not include GD, so you will need to install one that does:     it is simplest to use the one line installation instructions at [http://php-osx.liip.ch/](http://php-osx.liip.ch/.).\n\nEdit  /etc/apache2/httpd.conf using a text editor (e.g. TextEdit). You must make two changes:\n\n* Enabling php, by removing the initial hash symbol from the line beginning \"#LoadModule php5_module\" (pre-yosemite), or adding a similar line with the path to wherever you installed PHP, eg:\n    \n    LoadModule php5_module    /usr/local/php5-5.3.29-20141019-211753/libphp5.so\n\n* Adding a new Directory directive, by inserting: \n\n```apache_conf\nAlias /librarian /Users/yourusername/Sites/librarian\n\u003cDirectory /Users/Yourusername/Sites/librarian\u003e\n    AllowOverride None\n    # Allow access from this computer\n    Require local\n    # Allow access from intranet computers\n    Require ip 10\n    Require ip 172.16 172.17 172.18 172.19 172.20\n    Require ip 172.21 172.22 172.23 172.24 172.25\n    Require ip 172.26 172.27 172.28 172.29 172.30 172.31\n    Require ip 192.168\n    # Insert Allow from directives here to allow access from the internet\n    # \"Require all granted\" opens access to everybody\n    \u003cIfModule mod_php5.c\u003e\n        php_value upload_max_filesize 400M\n        php_value post_max_size 800M\n    \u003c/IfModule\u003e\n    \u003cFilesMatch \"\\.(ini|conf)$\"\u003e\n        Require all denied\n    \u003c/FilesMatch\u003e\n\u003c/Directory\u003e\n\u003cDirectory /Users/Yourusername/Sites/librarian/library\u003e\n    Require all denied\n\u003c/Directory\u003e\n```\n*Don't forget to change \"yourusername\" to your actual user name. You can find out your user name by typing `whoami` in Terminal.*\n\nYou may wish to alter who has access (e.g. to allow access from more IP numbers or domain names) - see the Apache [Authentication and Authorization HOWTO](https://httpd.apache.org/docs/2.4/howto/auth.html) for details.\n\n* Restart Apache, by typing `sudo apachectl restart` in Terminal\n* Install LibreOffice, Tesseract OCR, Ghostscript, and Poppler.\n* Download *I, Librarian* for Mac OSX and double-click the file to extract its contents. Rename the extracted directory to 'librarian' and move it to your *Sites* folder. (alternatively, you could `git clone` this repository).\n* Make sure that your *Sites* directory is accessible to *Others*. Use the `Get Info` dialog of the *Sites* directory to change permissions for *Everyone* to access and read (alternatively, run `chmod o+r ~/Sites/` at the terminal). You also need to make sure *Everyone* has **Execute** permissions for your home directory.\n* Change the owner of the 'library' sub-folder to the Apache user (_www for the default install). You can do this at the Terminal: `chown -R _www ~/Sites/librarian/library/`.)\n* Open your web browser and go to [http://127.0.0.1/librarian](http://127.0.0.1/librarian).\n\n### First use\n* Note on security: These installation instructions allow access to your library only from local computer\n  or an internal network. If you open access from the Internet you must change `$hosted` value to `true`\n  in data.php, line 10. Failure to do so may open your computer to various attacks.\n* In order to start *I, Librarian*, open your web browser, and visit:\n  [http://127.0.0.1/librarian](http://127.0.0.1/librarian)\n* Replace `127.0.0.1` with your static IP, or qualified server domain name, if you have either one.\n* Create an account and head to *Tools-\u003eInstallation Details* to check if everything checks fine.\n* You should also check *Tools-\u003eSettings* to run *I, Librarian* the way you want.\n\n**Thank you for installing *I, Librarian*!**\n\n### Un-installation\n* If you used the DEB package, execute the `uninstall.sh` un-installer.\n* Otherwise un-install all programs that you installed solely to use *I, Librarian*.\n* These may include Apache and PHP. **Note: You might have other programs using these. Only remove if sure.**\n* Delete *I, Librarian* ('librarian') directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkucej%2Fi-librarian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmkucej%2Fi-librarian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkucej%2Fi-librarian/lists"}