|Last Updated||Ratings||Unique User Downloads||Download Rankings|
|2018-04-11 (3 months ago)||70%||Total: 152||All time: 8,541 This week: 417|
|noter 0.36||GNU General Publi...||5.4||PHP 5, Content management|
This package can be used to create and manage notes shared between users.
: https://tinram.github.io/images/noter.png ![noter]
Share notes and code via a browser on a home / internal network without awkward PC connections or Internet transfer obstructing.
Quickly post and view notes on the same network e.g. save a note from a Linux PC and read on a Windows PC, without needing to invoke WinSCP or use network sharing such as Samba or NFS.
The focus is simplicity - browser display and search, with a log-in to add, edit, and delete notes.
The log-in offers basic protection from unauthorised tampering via password obfuscation and session timeout. Noter was created for an isolated network where plain text transfer and viewing is acceptable, and without determined adversaries. Noter is NOT suitable for storing sensitive data.
A single SQLite database file facilitates easy backup, transfer, and source control of data.
A Raspberry Pi, with Apache and PHP installed, could make an ideal low-powered always-on host for Noter.
A PHP server with the following modules enabled:
git clone the Noter repo files into the chosen web server directory.
(XAMPP and WAMP are suitable servers for Windows.)
For the following example on a Linux machine, the chosen directory is called noter/
In the terminal:
cd to the web directory (usually /var/www/html/).
sudo to the following commands as necessary:
chown -R <username>:www-data noter/ # Debian-based, username as owner allows file editing (chown -R <username>:apache noter/ # CentOS)
chown www-data noter/log/badlog.txt
chmod 600 noter/log/badlog.txt
Very important for the SQLite file operation (needs to be actioned on the directory itself):
chown -R www-data noter/db/
Check the configuration file constants: noter/config/config.php
Only the timezone, session constants, and
CONFIG_NUM_NOTES_DISPLAYED are of immediate interest, unless you wish to revise the SQLite database schema.
Change the users and passwords in the editing log-in gateway (classes/login.class.php). The default usernames (
USER2) are martin and alison, and both passwords are P@55w0rd. More users can be easily added (at the top of the file and in
Passwords are stored as SHA-256 hashes.
$USER1_PASS etc can be replaced with a hash generated from a website service or by running one of the following commands in a terminal and copying the output hash:
echo -n 'PASSWORD' | sha256sum
php -r "echo hash('sha256', 'PASSWORD');"
python -c "import hashlib;print(hashlib.sha256('PASSWORD'.encode()).hexdigest())"
python3 -c "import hashlib;print(hashlib.sha256('PASSWORD'.encode()).hexdigest())"
Noter includes an initial SQLite database: db/noter.sqlite3
However, where GitHub importing does not permit binary files (e.g. PHPClasses and the noter.sqlite3 file is consequently missing, the file will need to be created manually -
In a terminal:
cd db/ sudo sqlite3 noter.sqlite3 .read noter_schema_data.sql .exit sudo chown www-data:www-data noter.sqlite3
or better, configure an Apache vhost:
or if Apache rewrite is disabled:
Upon logging-in through this page, notes can be added, updated, or deleted.
</code> tags can be used to highlight code snippets.
</pre> preserves whitespace (both spaces and copy/pasted tabs).
</code> does not preserve whitespace.
Most types of link references will be automatically converted into HTML links upon note addition (but not on note updating).
The SQLite database schema is available at db/noter\_schema.sql
The SQLite database schema and initial data is available at db/noter\_schema\_data.sql
Unsuccessful log-in attempts are recorded in log/badlog.txt
Noter was originally created as a second language flashcard viewer (to which it can be easily reverted).
Noter was never coded for elegance, merely to do a simple job in minimal code. It's like my car: looks a wreck, runs quite well.
Noter is released under the GPL v.3.
|classes (4 files)|
|config (1 file)|
|css (1 file)|
|db (2 files)|
|includes (2 files)|
|js (2 files)|
|log (1 file)|
|Version Control||Unique User Downloads||Download Rankings|