about summary refs log tree commit diff stats
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README130
1 files changed, 130 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..9f6dc52
--- /dev/null
+++ b/README
@@ -0,0 +1,130 @@
+                       ━━━━━━━━━━━━━━━━━━━━━━━━━
+                                 TAURUS
+                        Taurus parses Call logs
+
+                                Andinus
+                       ━━━━━━━━━━━━━━━━━━━━━━━━━
+
+
+Table of Contents
+─────────────────
+
+Installation
+Documentation
+News
+
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ Website          <https://andinus.nand.sh/taurus>
+ Source           <https://git.tilde.institute/andinus/taurus>
+ GitHub (mirror)  <https://github.com/andinus/taurus>
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+
+Installation
+════════════
+
+  Taurus is released to `fez', you can get it from there or install it
+  from source. In any case, `zef' is required to install the
+  distribution.
+
+  You can run Taurus without `zef'. Just run `raku -Ilib bin/taurus'
+  from within the source directory.
+
+
+Release
+───────
+
+  1. Run `zef install taurus'.
+
+  Taurus should be installed, try running `taurus --version' to confirm.
+
+
+From Source
+───────────
+
+  You can either download the release archive generated by cgit/GitHub
+  or clone the project if you have `git' installed.
+
+
+Without `git'
+╌╌╌╌╌╌╌╌╌╌╌╌╌
+
+  1. Download the release:
+     • <https://git.tilde.institute/andinus/taurus>
+     • <https://github.com/andinus/taurus/releases>
+  2. Extract the file.
+  3. Run `zef install .' in source directory.
+
+
+With `git'
+╌╌╌╌╌╌╌╌╌╌
+
+  All commits will be signed by my [PGP Key].
+
+  ┌────
+  │ # Clone the project.
+  │ git clone https://git.tilde.institute/andinus/taurus
+  │ cd taurus
+  │
+  │ # Install taurus.
+  │ zef install .
+  └────
+
+
+[PGP Key]
+<https://andinus.nand.sh/static/D9AE4AEEE1F1B3598E81D9DFB67D55D482A799FD.asc>
+
+
+Documentation
+═════════════
+
+  Taurus parses Call logs exported by [OpenContacts]. Get the
+  application from F-Droid and export the call logs by selecting /More/,
+  then /Export call log/ from the three dot menu on top right.
+
+
+[OpenContacts]
+<https://f-droid.org/en/packages/opencontacts.open.com.opencontacts/>
+
+Implementation
+──────────────
+
+  It parses the exported log file line by line, stores them & presents
+  an interface.
+
+
+Options
+───────
+
+log
+╌╌╌
+
+  Exported log file.
+
+
+digits
+╌╌╌╌╌╌
+
+  Number of significant digits in phone numbers. Default is set to 10.
+  If the number of digits is less than significant digits then the
+  number is discarded, if it's more then the initial extra digits are
+  discarded (Country Code, etc.).
+
+
+News
+════
+
+v0.1.0 - 2021-08-15
+───────────────────
+
+  Initial Implementation.
+
+  ⁃ Present overall stats.
+  ⁃ Displays contact specific stats.
+    ⁃ Outgoing
+    ⁃ Incoming
+    ⁃ Total Call Time
+    ⁃ Declined
+    ⁃ They Declined
+    ⁃ Missed Calls