paritybit.ca

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs | README | LICENSE

commit 7922792757be63e7c17ea8d2a465c168291f2457
parent a8a01413293dfd36fc70598d3271f7612a91be16
Author: Jake Bauer <jbauer@paritybit.ca>
Date:   Mon, 28 Sep 2020 00:31:07 -0400

Add project pages

Diffstat:
Agemini/pages/projects/kontaktdb.gmi | 44++++++++++++++++++++++++++++++++++++++++++++
Agemini/pages/projects/usrmnt.gmi | 59+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Agemini/public/img/usrmnt-screenshot.png | 0
3 files changed, 103 insertions(+), 0 deletions(-)

diff --git a/gemini/pages/projects/kontaktdb.gmi b/gemini/pages/projects/kontaktdb.gmi @@ -0,0 +1,44 @@ +# kontaktdb + +kontaktdb (/ˈkɑntækt diː biː/ or "contact D B") is a contact management application that I made in order to store, retrieve, and edit basic contact information in plain text because I wasn't happy with the existing software available. + +Right now it supports adding the following contact information: + +* Name +* Email address + +There are plans to add more supported categories and custom categories in the future. + +kontaktdb is a simple shell script not much larger than a hundred lines of code. It is POSIX compliant except for the use of `sed -i`. This means it should run on almost every *nix environment including Linux distributions and BSDs. + +The program used to be called 'kontakt' but then I found out the KDE project has a project called 'Kontact' and I opted to rename to reduce confusion. I am not overly attached to the name so if you've come up with something better, please let me know. + +### Why Does This Exist? + +I didn't like the existing options for managing contacts on the command line. Programs like abook and khard are nice, but I wanted something much, much simpler since I didn't need the complexity offered by the other options. + +The goals for this program are: + +* Contact database entirely in plain text with tab-delimited fields. +* Support for contact names and emails (possibly more later, but not much more). +* Really simple set of commands to interact with the database. + +The overarching goal of the project is to provide a really simple way to manage basic contact information. There is no planned support for anything more than plain text with each line having tab-delimited fields representing one contact; if you need CardDAV support or anything else like that, this is not the application for you. + +### Download + +Download the latest release here: + +=> https://git.sr.ht/~jbauer/kontaktdb/refs Project releases page + +### Installing, Using, and Customizing + +Please refer to the README file for instructions on installating, using, and customizing the software. + +### Contributing + +If you would like to submit a bug report, suggest a feature, or have any other feedback or contribution that you are thinking about submitting, you can post it on the project’s public mailing list. + +If you’ve made changes to the code which you wish to share with me, I accept contributions through email which you can learn how to do here: + +=> https://git-send-email.io diff --git a/gemini/pages/projects/usrmnt.gmi b/gemini/pages/projects/usrmnt.gmi @@ -0,0 +1,59 @@ +# usrmnt + +Pronounced /juːzɚ maʊnt/ or "user mount", usrmnt is a small utility to mount, unmount, unlock, etc. your devices from the command line with an intuitive command syntax and using an intuitive text-based UI. It is effectively a wrapper for udisksctl to make it more friendly to use. + +## Screenshots + +=> gemini://paritybit.ca/img/usrmnt-screenshot.png A screenshot of usrmnt in action + +## Download + +=> https://git.sr.ht/~jbauer/usrmnt Get it from the Git Repository + +As always, I am open to any feedback, requests, bug reports, or contributions you may have. Please send these to the sourcehut git repository as git.paritybit.ca is just a mirror. + +## Contributing + +If you would like to submit a bug report, suggest a feature, or have any other feedback or contribution that you are thinking about submitting, you can post it on the project's public mailing list. + +If you've made changes to the code which you wish to share with me, I accept contributions through email which you can learn how to do here: + +=> https://git-send-email.io/ git-send-email.io + +## Manual + +Simply run the script with no arguments: `usrmnt`. You will then be presented with a listing of the currently recognized devices in your computer and a command prompt. The usage of that command prompt is detailed below: + +``` +Options: + ls – List the currently recognized devices + q – Exit + v – Print the current version + ? – Print this help dialog + &lt;command&gt; &lt;device&gt; – Execute &lt;command&gt; on &lt;device&gt; where &lt;command&gt; is one of: + Supported udisks Commands: + mount – Mount a device to a mountpoint in /media. Will prompt to + unlock encrypted drives. + unmount – Unmount a device (can also use "umount") + lock – Lock an unlocked encrypted device + unlock – Unlock an encrypted device without mounting it + info – Print device info + power-off – Power a device off (computer will stop recognizing it) + (can also use "poweroff") + Examples: + ()&gt;&gt;&gt; mount sdc1 + (sdc1)&gt;&gt;&gt; unmount sdb2 + (sdb2)&gt;&gt;&gt; unlock mmcblk0p1 + + The device in parentheses is the device from the previous command. + When there is a device in parentheses, you can type any command without + specifying a device name and that command will act on the device in + parentheses. The device in parentheses is only updated when the previous + command completed successfully except if you are unlocking a device, it + exists, and you get the password wrong in which case it will still update + so you can just type "unlock" or "mount" again. + + For example: + (sdb1)&gt;&gt;&gt; unmount + will unmount /dev/sdb1. +``` diff --git a/gemini/public/img/usrmnt-screenshot.png b/gemini/public/img/usrmnt-screenshot.png Binary files differ.