pub / rememori

Simple file-based bookmarking and notes application
git clone https://src.jayvii.de/pub/rememori.git
Home | Log | Files | Exports | Refs | README | RSS

README.md (6060B)


      1 # Rememori
      2 
      3 Please send patches or remarks to
      4 [jayvii+rememori[AT]posteo[DOT]de](mailto:jayvii+rememori[AT]poste[DOT]de)
      5 
      6 A simple file-based, database-free bookmarking and notes application that is
      7 light on resources.
      8 
      9 ## Features
     10 
     11 Rememori is currently is heavy development and the feature set may change at any
     12 time! Here are the currently implemented most important ones.
     13 
     14 Rememori has multi-lingual support, all screenshots you see below are in German,
     15 however, Rememori switches transparently between languages, depending on your
     16 web browser's configuration. CUrrently supported are:
     17 
     18 - English
     19 - German
     20 
     21 Rememori uses the superb [Simple.CSS](https://simplecss.org/) class-less styling
     22 framework, which supports automatic dark and bright mode. The screenshots below
     23 show **both** modes at the same time.
     24 
     25 ### Categories
     26 
     27 Bookmarks / Notes are stored file-based in simple `.txt` files, which are sorted
     28 within categories that are created automatically and swiftly on-demand, whenever
     29 you create a new note.
     30 
     31 The main view shows you all categories and how many notes each one contain. The
     32 category buttons are sorted by number of notes in each. From here you can
     33 directly jump into your notes!
     34 
     35 ![Main "Categories" view of Rememori](https://paste.jayvii.de/c750fbcf8a2c452b5d889167ae39c41ef68b74361d1e1635a0863b63d2ab15c1)
     36 
     37 ### Notes List
     38 
     39 Clicking on any of the Categories, lists all notes within this category in a
     40 simple list. If the note contains a URL in the first line of its content, the
     41 item-title in the list will turn into a link to that URL.
     42 
     43 You can also view / change and delete the note from that list. The list is
     44 sorted based by time / date of the last change to a note.
     45 
     46 ![The Notes List of Rememori](https://paste.jayvii.de/5a63c0f0a02bbc72ff8785a36b647d44882f37b33faadb9cc1ca665ba12d924b)
     47 
     48 ### Creating and Editing Notes
     49 
     50 Notes are written in simple, unstructed text (hence the `.txt` file it is stored
     51 in). The "View" / "Edit" as well as the "New Note" mode gives you the ability to
     52 change a note's content, its category and its name.
     53 
     54 Leaving the category portion empty, will assign the note into the `unknown`
     55 category. If you leave the file name field empty, Rememori will try to figure
     56 out an appropriate file name itself.
     57 
     58 If the first line of the note contains a URL, Rememori will try to fetch the
     59 webpage's name and use it as the name of your note (you can see the result of
     60 this on the screenshot below):
     61 
     62 ![The edit-mode for a note in Rememori](https://paste.jayvii.de/c8337571c3b8ad29f72baed83353b2611d7ce0047de6f2391958fc0f5491c502)
     63 
     64 ### Search
     65 
     66 Rememori also has a simple search integrated. It will simply match the keywords
     67 you type into the search field with all notes' content and title. It then
     68 provides you with a list of all notes that had matches, sorted by the number of
     69 matches.
     70 
     71 ![The search-mode in Rememori](https://paste.jayvii.de/7a8349abde12d6c6c3fba76aa3a68354d1310175a98e384c7ab0a3418af059cb)
     72 
     73 ### API Endpoints
     74 
     75 Rememori provides simple API endpoints that can be used via `POST` and `GET`
     76 requests.
     77 
     78 The `/api/new.php` endpoint will create a new note given the `user`, `token` and
     79 `content` arguments as well as the optional `category` argument.
     80 
     81 The `/api/rss.php` endpoint will return an
     82 [Atom RSS Feed](https://en.wikipedia.org/wiki/Atom_(Web_standard)) sorted by
     83 time/date of all notes or for a specific category (for example a `ReadLater`
     84 category). It requires the `user` and `token` arguments as well as the optional
     85 `category` argument.
     86 
     87 ## Using Shortcuts to save Notes to Rememori
     88 
     89 ### Desktop (Webbrowser)
     90 
     91 Rememori features a simple bookmarklet in the navigation menu. A user can
     92 simply drag this into their web browser's bookmarks toolbar to send any webpage
     93 they are currently to to Rememori with a single click on the bookmark item in
     94 their browser's toolbar.
     95 
     96 The bookmarklet contains a simple Javascript function (created in
     97 [lib/bookmarklet.php](https://src.jayvii.de/pub/rememori/file/lib/bookmarklet.php.html))
     98 that will prompt the user for a category and send the currently opened page of
     99 your web browser to the `/api/new.php` [API endpoint](#api-endpoints).
    100 
    101 ### Android
    102 
    103 On Android, you may use Apps like
    104 [HTTP Shortcuts](https://http-shortcuts.rmy.ch/) (also available on
    105 [F-Droid](https://f-droid.org/en/packages/ch.rmy.android.http_shortcuts/)) to
    106 share text and URLs through Android's share-intend.
    107 
    108 To set up HTTP Shortcuts, open the app and
    109 [create new variables](https://http-shortcuts.rmy.ch/variables):
    110 
    111 1. `rememori_server`: "https://rememori.example.com" (your rememori URL)
    112 2. `rememori_user`: "me" (your username)
    113 3. `rememori_token`: "my-secret-token" (an extra password you need to create)
    114 4. `text_and_url`. Ensure this variable has the options "Allow Share..." and
    115    "only text" checked
    116 
    117 Then create a new shortcut for each share-option with its own category. Name it
    118 appropriately, for example `Rememori (category: ReadItLater)`.
    119 
    120 Under "General settings", set the method `GET` and insert following URL (adjust
    121 the category accordingly. In the example below it is `ReadItLater`):
    122 
    123 ```
    124 {rememori_server}/api/new.php?category=ReadItLater&user={rememori_user}&token={rememori_token}&content={text_and_url}
    125 ```
    126 
    127 Save the shortcut and you are good to go! When sharing text or URLs from any
    128 app, you may now choose the newly created shortcut to send it directly to your
    129 rememori instance.
    130 
    131 ## FAQs
    132 
    133 1. **How do I add the bookmarklet to my Web-Browser?**
    134 
    135 Simply go to the "Account" section in Rememori and drag the button labeled
    136 "Rememori" under the Bookmarklet section to your browser's bookmarks toolbar:
    137 
    138 ![Dragging the bookmarklet to the bookmarks toolbar](https://paste.jayvii.de/4e6ef06f4dc463e4aa6bed5681c3176a6a96221d0b5b0660d18bd0072a703f79)
    139 
    140 [You can find a higher resolution video here](https://paste.jayvii.de/369db1fd82260da5f50b1c7865764b122fa7f5d1ac4f506d2c0dc11079556e03)
    141 
    142 ## Setup
    143 
    144 Coming soon...
    145 
    146 ## License
    147 
    148 Rememori is licensed under AGPL-3.0-or-later.
    149 
    150 Other bundled assets are:
    151 
    152 - [simple.css](https://simplecss.org/): MIT License (c) Kev Quirk