1
0
Fork 0
tinmop/doc/tinmop.org

724 lines
25 KiB
Org Mode
Raw Normal View History

2020-05-08 15:45:43 +02:00
#+TITLE: tinmop
* Name
2022-02-05 16:33:53 +01:00
2022-12-12 20:21:31 +01:00
tinmop - a client for gemini, gopher, pleroma social network and 9p protocol over TLS
2020-05-08 15:45:43 +02:00
* Synopsis
2021-11-16 16:26:28 +01:00
tinmop [OPTION]…
2020-05-08 15:45:43 +02:00
* Description
2020-06-07 12:38:25 +02:00
This document assumes basic knowledge of how fediverse works. More
2021-11-16 16:26:28 +01:00
information about this topic can be found on the following websites:
- [[https://en.wikipedia.org/wiki/Fediverse]] ;
- [[https://pleroma.social/]] ;
- [[https://docs.joinmastodon.org/]] .
2020-05-08 15:45:43 +02:00
2021-11-16 16:26:28 +01:00
Tinmop proposes an extensible terminal interface to connect with
2022-12-12 20:21:31 +01:00
Pleroma social network, the gemini and gopher protocol
2020-12-27 13:19:32 +01:00
2021-11-16 16:26:28 +01:00
- gemini://gemini.circumlunar.space/
- [[https://gemini.circumlunar.space/docs/]]
2020-05-08 15:45:43 +02:00
2022-02-05 16:33:53 +01:00
Finally tinmop can connect to network file system using 9p protocol
over TLS (using client certificates as authentication method).
For more information about this feature, please visit:
[[https://kamid.omarpolo.com/]].
2020-05-08 15:45:43 +02:00
* Options
2020-06-07 12:38:25 +02:00
2020-05-08 15:45:43 +02:00
Without options the program will start a terminal interface and will
try to connect to your instance (see [[Configuration]])
2022-02-05 16:33:53 +01:00
+ -o, --open-net-address ARG :: Open net address (currentli only gemini or 9p)
2020-06-07 12:38:25 +02:00
+ -m, --notify-mentions ARG :: Notify messages that mentions the user
+ -R, --reset-timeline-pagination ::
Reset the timeline pagination. By default the new toots are fetched
starting from the last one downloaded from the instance, this switch
will force the program to fetch the last message posted by users
2021-11-13 16:34:07 +01:00
+ -G, --gemini-client-only :: Start as gemini client only
+ -c, --check-follows-requests :: Checks for follow request at start
+ -e, --execute-script SCRIPT-FILE :: Execute a script file
+ -f, --folder FOLDER-NAME :: Start on that folder
+ -h, --help :: print program help and exit
+ -t, --timeline TIMELINE-NAME :: Start using this timeline
+ -u, --update-timeline :: Update the selected timeline
+ -U, --gemini-gui-client-only :: Start the program as A gemini GUI client
+ -S, --gemini-gui-server-only :: Start as gemini gui server only
+ -v, --version :: Print program version and exit
2020-05-08 15:45:43 +02:00
* Usage
Users of Tinmop supposed to interact with the social network using a
terminal interface (TUI, but starting with version 0.9.9.1414 a GUI
for gemini is available), The terminal screen layout is sketched
below:
2020-05-08 15:45:43 +02:00
#+NAME: screen-layout
#+BEGIN_SRC text
+---------------+---------------------------+
| | |
| tags window | thread windows |
| | |
| | modeline |
+---------------+---------------------------+
| | |
2021-01-04 21:30:55 +01:00
| conversations | main window |
2020-05-08 15:45:43 +02:00
| window | |
| | |
| | |
+---------------+---------------------------+
| command window |
+-------------------------------------------+
#+END_SRC
The screen is subdivided in five window:
- tag window :: shows the tag users subscribed for and available messages for each tag;
2020-05-08 15:45:43 +02:00
2021-11-16 16:26:28 +01:00
- threads window :: for a given timeline and folder (see [[Folders]]) show the discussions saved in user's local database;
2020-05-08 15:45:43 +02:00
- conversations window :: show the /private/ conversations the user is having with others;
2021-01-04 21:30:55 +01:00
- main window :: show the body of the message selected in the tag window or gemini page
2020-05-08 15:45:43 +02:00
- command window :: the window where the user instruct the software to perform commands
2021-11-16 16:26:28 +01:00
Using the program in gemini exclusive mode (option *"-G"*) the program layout is simplified:
#+NAME: screen-layout-gemini-fullscreen
#+BEGIN_SRC text
+------------------------------------------+
| |
| main window |
| |
| |
| |
+------------------------------------------+
| command window |
+------------------------------------------+
#+END_SRC
The main way to interact with the program is using the keyboard. By
default you can move focus to each window (except command window
that can not get focus explicitly) using *'M-arrow key'* (meta is
*ALT* on many keyboards). There is a contextual help that appears
when the user input data that provide hints about commands and a
quick help window that can be shown by hitting ~?~ (if this
keybinding has not been customized).
2020-05-08 15:45:43 +02:00
** Command window keys
2021-11-16 16:26:28 +01:00
The command window has a few hardcoded command keys to interact
with it:
2021-11-16 16:26:28 +01:00
- the *left* and *right* arrow keys move the cursor;
- the key *home* and *end* move the cursor to the start and end of
the input respectively;
- *canc* and *backspace* delete the next and previous character
respectively;
- the *new line* (often called *enter* key) send the input to the
program;
- *C-k* (that is: "press 'control' and while pressed press 'k')
/kills/ (deletes) the text from the cursor position to the end of
the input previously typed;
- press *M-left* and *M-right* (*left alt* and *left* or *right*
arrow together) to browse pages of the suggestion window; the
suggestion window is a window that holds a previously inputted
data that are compatible with the string the user is typing into
the command window;
- if suggestions are gemini URI press *TAB* to input the current
selected suggestion;
- if suggestion window is *not* rendered, pressing *up* and *down*
arrow keys will cycle through input history, if there is not a
suggestion window rendered pressing *up* and *down* will scroll
on suggestions.
2020-05-08 15:45:43 +02:00
** Folders
A folder is an object to groups messages for each timeline an
arbitrary number of folders can be created, when the last message of
2020-05-08 15:45:43 +02:00
a folder is deleted the folder is deleted as well.
* Configuration
The configuration of tinmop is based on text files but there are
2020-05-08 15:45:43 +02:00
available two different kind with different syntax and scope.
- a key-value text files used to configure the access credential to
server and visual theme of the program (simple configuration);
2020-05-08 15:45:43 +02:00
- common lisp source code. Used to write module (AKA plugin) and to
configure keybindings to interact with the software.
2020-05-08 15:45:43 +02:00
The distribution of this software comes with a bunch of pre-backed
2020-05-08 15:45:43 +02:00
configuration files but user is expected to write a simple file with
their credential to log into the server.
** Simple configuration
This is a simple file with each entry in a single line that look like this:
#+NAME: simple file example
#+BEGIN_SRC text
# a line starting with a '#' is a comment
2020-05-08 15:45:43 +02:00
# a file can be included in another with this directive:
# use "shared.conf"
2020-05-08 15:45:43 +02:00
# The server instance name
server = server address
# your username
username = username
#+END_SRC
2021-11-16 16:26:28 +01:00
Not incidentally the information in the example above are the
absolute minimum the user has to provide before starts the program
and connect to pleroma (to use tinmop as a gemini browser only an
empty file will suffice): the name you chose when you made the
2020-12-27 13:19:32 +01:00
account on the server and the address of the server.
2020-05-08 15:45:43 +02:00
As you can see a line starting with a *#* is considered comment and
skipped by the program
The file with this credential are confidential and must be put into
user's home directory under the path
~$HOME/.local/share/tinmop/main.conf~. Probably the directory
2020-05-08 15:45:43 +02:00
~tinmop~ does not exists on user system, if it does not exists must
be created manually.
If the program was installed correctly two other files with simple
semantics are located in your system wide configuration directory
(usually ~/etc/tinmop/~), please check these files for more
information, as they are extensively commented.
2020-05-08 15:45:43 +02:00
Is worth mentioning again that, without an user configuration file,
the program can be used as gemini client (see the "-G" command line
switch on top of this manual).
2020-05-08 15:45:43 +02:00
** Lisp program
These files contains Common lisp (see [[https://common-lisp.net/]])
source code. And are used both as a way to configure the program
2020-05-08 15:45:43 +02:00
and to write module for tinmop itself.
These files are the only way to configure program's keybindings:
sequence of pressing button to fire command commands (do not worry
2020-05-08 15:45:43 +02:00
it is not too difficult!).
These files must be a valid Common Lisp program to allow the
program to even starts. Again this is actual source code that is
loaded end executed by the main program; be careful, do not copy
and paste code from untrusted sources as this could results in a
2020-05-08 15:45:43 +02:00
*severe* security damage.
Again in the configuration directory there is a (commented) file
named ~init.lisp~ that user can use as their starting point to
write their files. A custom init file, or other module files, must
be located into the directory ~$HOME/.local/share/tinmop/~.
2020-05-08 15:45:43 +02:00
However there is no need to write their own init file if user is
2020-05-08 15:45:43 +02:00
happy with the provided one by the package maintainers.
* First time start
After the configuration the program can be started but we are not
ready to join the fediverse yet because tinmop need to be /trusted/ by
the server. Just follows the instruction on screen to register the
application with your instance. This procedure should be followed
once: when the program starts for the first time (but please note
2020-05-08 15:45:43 +02:00
that there must be a file with valid credentials available).
2021-11-16 16:26:28 +01:00
There is no additional steps to follow to connect to gemspace,
instead.
* Gempub support
2021-11-16 16:26:28 +01:00
Tinmop maintains a gempub library scanning a directory on your
file system (library directory); the library directory path can be
set using the configuration directive:
#+BEGIN_SRC text
gempub.directory.library = /absolute/path/to/your/gempub/library
#+END_SRC
2021-11-16 16:26:28 +01:00
the default value is ~$XDG_DATA_HOME~ (usually something like
~$HOME/.local/share/tinmop/~).
2021-11-16 16:26:28 +01:00
Using *'M-g g l'* the library can be inspected using a simple query
language (similar to SQL) that search in the metadata of the gempub
files, example of query follows:
#+BEGIN_SRC text
where author like "calvino" and published < "1980"
where author like "cal%" or published = "1980"
#+END_SRC
Valid search keys are:
- title;
- author;
- language;
- description;
- publish-date;
- revision-date;
- published;
- copyright.
2021-11-16 16:26:28 +01:00
You can use ~< > = != <= >= like~ operators for comparison and the
two logical operator ~and~ and ~or~, the character ~%~ act like a
wildcard and means: /'any sequence of character'/.
2021-11-16 16:26:28 +01:00
Note that the right hand side of the operator must be wrapped in
quotes.
2021-11-16 16:26:28 +01:00
After the search is performed a window with the results is shown,
selecting an item of this window will open the gempub and will add
all its table of contents on the tour mode, so that the book could
be browsed.
2021-11-16 16:26:28 +01:00
For more information on tour mode see below or use
*'C-h A <enter> tour mode'*.
* Tour mode
2021-11-16 16:26:28 +01:00
Tinmop maintains a queue of links that can be then visited by the
user, this queue is called *tour*.
There are two ways to add a link to the tour:
2021-11-16 16:26:28 +01:00
- when a link window is open and focused pressing *t* will start a
prompt for link indices to be saved in the tour; the prompt expect
a simple, comma or space separated, list of indices or index range, index
range is a couple of index separated by a dash, example below:
2021-11-16 16:26:28 +01:00
#+BEGIN_SRC text
1 2 5 8-12
#+END_SRC
2021-11-16 16:26:28 +01:00
The string above will save the link index number 1, 2, 3, 5, 8, 9,
10, 11, 12 to the tour.
2021-11-16 16:26:28 +01:00
The other way to add links to the tour is using the command
*'gemlog-add-unread-posts-tour'* (default keychord: *'M-g s t a'*)
that will add all the unread posts to the tour.
There are a few more useful command to manipulate the tour:
- next-tour-link :: (*'M-t t'* or just 't' if a gemini window is focused)
2021-11-16 16:26:28 +01:00
follows the next link in the tour;
- show-tour-links :: (*'M-t s'* or just *'T'* if a gemini window is focused)
2021-11-16 16:26:28 +01:00
shows the contents of the tour in a link window
- clean-all-tour :: (*'M-t c'*)
2021-11-16 16:26:28 +01:00
- shuffle-tour :: (*'M-t S'*) shuffle the contents of the tour
2020-05-08 15:45:43 +02:00
* How to get more help
2020-12-27 13:19:32 +01:00
For help with pleroma visit the pleroma website:
https://pleroma.social/
For information about gemini:
$ tinmop -o gemini://gemini.circumlunar.space
2020-05-08 15:45:43 +02:00
2021-11-16 16:26:28 +01:00
The program has an inline help (default binding for help is "?"), a
manpage (default binding to view the manpage is "C-h m") and inline
help can be searched (default: "C-h A").
2020-12-27 13:19:32 +01:00
2020-05-08 15:45:43 +02:00
Moreover you can have some useful hint at the program web page:
[https://www.autistici.org/interzona/tinmop/]
* Default keybindings
** Global keymap
2022-02-05 15:27:44 +01:00
- ! :: gemini-search
- > :: open-net-address
- ? :: print-quick-help
2022-02-05 15:27:44 +01:00
- C-a :: show-about-window
- C-h A :: apropos-help-global
2022-02-05 15:27:44 +01:00
- C-h a :: apropos-help
- C-h h :: print-quick-help
- C-h m :: open-manual
- M-c :: open-chats-list-window
2022-02-05 15:27:44 +01:00
- M-down :: pass-focus-on-bottom
- M-e :: eval-command
- M-g c i :: import-gemini-certificate
- M-g c s :: gemini-open-certificates-window
- M-g g b s :: display-bookmark
2022-02-05 15:27:44 +01:00
- M-g g l :: open-gempub-library
- M-g s o :: gemini-open-gemlog-window
- M-g s r :: gemlog-refresh-all
- M-g s t a :: gemlog-add-unread-posts-tour
- M-l :: load-script-file
- M-left :: pass-focus-on-left
2022-02-05 15:27:44 +01:00
- M-right :: pass-focus-on-right
- M-s l :: message-window-lock-scrolling
- M-s u :: message-window-unlock-scrolling
2022-02-05 15:27:44 +01:00
- M-t S :: shuffle-tour
- M-t c :: clean-all-tour
- M-t s :: show-tour-links
- M-t t :: next-tour-link
- M-up :: pass-focus-on-top
- q :: quit
** Follow request window
- C-J :: process-follow-requests
2022-02-05 15:27:44 +01:00
- d :: follow-request-delete
- down :: follow-request-go-down
- q :: cancel-follow-requests
2022-02-05 15:27:44 +01:00
- up :: follow-request-go-up
** Send post window
2022-02-05 15:27:44 +01:00
- C-J :: send-message
- d :: attach-delete
2022-02-05 15:27:44 +01:00
- down :: attach-go-down
- e :: edit-message-body
- m :: change-mentions
- q :: cancel-send-message
2022-02-05 15:27:44 +01:00
- s :: change-subject
- up :: attach-go-up
- v :: change-visibility
** Thread window
- / b :: thread-search-next-message-body
- / m :: thread-search-next-message-meta
- C-I :: thread-search-next-unread-message
2022-02-05 15:27:44 +01:00
- C-J :: thread-open-selected-message
- C-X m b :: boost-selected-status
- C-X m f :: favourite-selected-status
- C-X m r b :: unboost-selected-status
- C-X m r f :: unfavourite-selected-status
- C-X m s :: subscribe-to-hash
- C-X m t :: move-message-tree
- C-X m u :: unsubscribe-to-hash
- C-c c :: change-conversation-name
2022-02-05 15:27:44 +01:00
- C-c o :: open-conversation
- C-c u :: update-conversations
- C-f c :: change-folder
- C-t R :: reset-timeline-pagination
2022-02-05 15:27:44 +01:00
- C-t U :: update-current-timeline-backwards
- C-t c :: change-timeline
- C-t h r :: refresh-tags
2022-02-05 15:27:44 +01:00
- C-t u :: update-current-timeline
- C-u c k g :: crypto-generate-key
- C-u c k i :: crypto-import-key
- C-u c k s :: crypto-export-key
- C-u f :: follow-user
2022-02-05 15:27:44 +01:00
- C-u i :: ignore-user
- C-u r f :: start-follow-request-processing
- C-u r r :: report-status
- C-u u :: unfollow-user
- C-u v a :: view-user-avatar
2022-02-05 15:27:44 +01:00
- C-u x :: unignore-user
- D :: delete-post-using-regex
- M-u :: delete-and-move-previous
- N :: repeat-search
- P :: poll-vote
- U :: thread-mark-prevent-delete-selected-message
- X :: refresh-thread-totally
- \ \ b :: thread-search-previous-message-body
- \ \ m :: thread-search-previous-message-meta
- c :: compose-message
- d :: delete-and-move-next
- dc :: thread-mark-delete-selected-message
- down :: thread-go-down
- end :: thread-goto-last-message
- g :: thread-goto-message
- home :: thread-goto-first-message
- l :: open-message-link
- left :: open-previous
- n :: thread-search-next-unread-message
- r :: reply-message
- right :: open-next
- up :: thread-go-up
- v :: open-message-attach
- x :: refresh-thread
- | :: send-message-to-pipe
** Posts window
- / :: message-search-regex
2022-02-05 15:27:44 +01:00
- C-J :: message-scroll-down
- N :: repeat-search
2022-02-05 15:27:44 +01:00
- down :: message-scroll-down
- end :: message-scroll-end
- home :: message-scroll-begin
- left :: message-scroll-left
- npage :: message-scroll-next-page
- ppage :: message-scroll-previous-page
2022-02-05 15:27:44 +01:00
- right :: message-scroll-right
- up :: message-scroll-up
- | :: send-to-pipe
2022-10-01 18:25:54 +02:00
- b :: net-address-history-back
** Gemini viewer window
- / :: message-search-regex
2022-02-05 15:27:44 +01:00
- C-J :: message-scroll-down
- C-[ :: go-to-previous-link
- C-] :: go-to-next-link
- C-b a :: bookmark-gemini-page
- C-b d :: delete-gemini-bookmark
2022-02-05 15:27:44 +01:00
- C-b s :: display-bookmark
2022-12-12 20:21:31 +01:00
- I M :: collect and join together all the images linked from a gemini page and then display the resulting images
2022-02-05 15:27:44 +01:00
- N :: repeat-search
- O :: open-gemini-toc
- T :: show-tour-links
- U :: gemini-view-source
2022-02-05 15:27:44 +01:00
- ] :: open-next-visible-link
2022-10-01 18:25:54 +02:00
- b :: net-address-history-back
- c :: gemini-open-certificates-window
2022-02-05 15:27:44 +01:00
- d :: gemini-open-streams-window
- down :: message-scroll-down
- end :: message-scroll-end
- home :: message-scroll-begin
- l :: open-message-link
- left :: message-scroll-left
- npage :: message-scroll-next-page
- p :: message-toggle-preformatted-block
- ppage :: message-scroll-previous-page
- r :: gemini-refresh-page
2022-02-05 15:27:44 +01:00
- right :: message-scroll-right
- s :: gemini-subscribe-gemlog
- t :: next-tour-link
2022-02-05 15:27:44 +01:00
- up :: message-scroll-up
- | :: send-to-pipe
** Gemini page table of contents window
2022-02-05 15:27:44 +01:00
- C-J :: gemini-toc-scroll-down-page
- down :: gemini-toc-scroll-down
- n :: gemini-toc-scroll-down-page
- p :: gemini-toc-scroll-up-page
2022-02-05 15:27:44 +01:00
- q :: gemini-toc-close
- up :: gemini-toc-scroll-up
** Gemini stream window
2022-02-05 15:27:44 +01:00
- C-J :: gemini-streams-window-open-stream
- a :: gemini-abort-download
- down :: gemini-streams-window-down
- q :: gemini-streams-window-close
2022-02-05 15:27:44 +01:00
- up :: gemini-streams-window-up
** gemini certificates window
2022-04-25 13:09:55 +02:00
- d :: delete selected certificate
2022-04-25 13:07:26 +02:00
- C-J :: print information for the selected certificate
- down :: gemini-certificate-window-go-down
- q :: gemini-close-certificate-window
2022-02-05 15:27:44 +01:00
- up :: gemini-certificate-window-go-up
** Gemini subscription window
- C-J :: show-gemlog-to-screen
- d :: gemlog-cancel-subscription
2022-02-05 15:27:44 +01:00
- down :: gemlogs-subscription-go-down
- l :: open-message-link
2022-02-05 15:27:44 +01:00
- q :: close-gemlog-window
- up :: gemlogs-subscription-go-up
** Gempub library window
2022-02-05 15:27:44 +01:00
- C-J :: gempub-open-file
- down :: gempub-library-window-go-down
- q :: gempub-library-window-close
2022-02-05 15:27:44 +01:00
- up :: gempub-library-window-go-up
** Post's tag window
- C-J :: open-tag-folder
- U :: unsubscribe-to-hash
2022-02-05 15:27:44 +01:00
- down :: tag-go-down
- r :: refresh-tags
2022-02-05 15:27:44 +01:00
- up :: tag-go-up
** Conversations window
- C-J :: goto-conversation
2022-02-05 15:27:44 +01:00
- C-c c :: change-conversation-name
- I :: ignore-conversation
2022-02-05 15:27:44 +01:00
- dc :: delete-conversation
- down :: conversation-go-down
- up :: conversation-go-up
** Attachments window
- C-J :: open-message-attach-perform-opening
- a :: open-all-message-attachments
- down :: open-message-attach-go-down
- q :: close-open-attach-window
2022-02-05 15:27:44 +01:00
- up :: open-message-attach-go-up
** Links window
2022-02-05 15:27:44 +01:00
- / :: search-link-window
- C-J :: open-message-link-perform-opening
2022-02-05 15:27:44 +01:00
- N :: repeat-search
- T :: save-selected-message-in-tour
- down :: open-message-link-go-down
- e :: open-message-link-open-enqueue
2022-02-05 15:27:44 +01:00
- q :: close-open-message-link-window
- t :: tour-mode-link
2022-02-05 15:27:44 +01:00
- up :: open-message-link-go-up
** Chats list window
- C-J :: show-chat-to-screen
2022-02-05 15:27:44 +01:00
- R :: refresh-chats
- c :: chat-create-new
- down :: chat-list-go-down
2022-02-05 15:27:44 +01:00
- l :: change-chat-label
- q :: close-chats-list-window
- r :: refresh-chat-messages
- up :: chat-list-go-up
** Chat window
2022-02-05 15:27:44 +01:00
- / :: message-search-regex
- M-c :: write-to-chat
2022-02-05 15:27:44 +01:00
- a :: open-chat-link-window
- down :: message-scroll-down
- end :: message-scroll-end
2022-02-05 15:27:44 +01:00
- home :: message-scroll-begin
- npage :: message-scroll-next-page
- ppage :: message-scroll-previous-page
2022-02-05 15:27:44 +01:00
- up :: message-scroll-up
** File explorer
2022-02-05 15:27:44 +01:00
- / :: file-explorer-search
- C-J :: file-explorer-open-node
- D :: file-explorer-delete-tree
2022-02-05 15:27:44 +01:00
- M d :: file-explorer-download-mirror
- M u :: file-explorer-upload-mirror
2022-02-06 13:47:51 +01:00
- M-m :: file-explorer-mark-by-regexp
2022-02-05 15:27:44 +01:00
- N :: repeat-search
- X :: file-explorer-delete-marked
- a :: file-explorer-create-path
2022-02-05 15:27:44 +01:00
- c :: file-explorer-close-path
- d :: file-explorer-download-path
- down :: file-explorer-go-down
- e :: file-explorer-edit-file
2022-02-05 15:27:44 +01:00
- end :: file-explorer-scroll-end
- home :: file-explorer-scroll-begin
- i :: file-explorer-node-details
2022-02-05 15:27:44 +01:00
- m :: file-explorer-mark-entry
- q :: file-explorer-close-window
- r :: file-explorer-rename-path
- u :: file-explorer-upload-path
- up :: file-explorer-go-up
- x :: file-explorer-expand-path
2022-10-01 18:25:54 +02:00
** Gopher window
- up :: gopher-window:go-to-previous-link
- down :: gopher-window:go-to-next-link
- k :: gopher-window:go-to-previous-link
- j :: gopher-window:go-to-next-link
- C-J :: gopher-window:open-menu-link
- b :: net-address-history-back
- C-b a :: bookmark-gopher-page
- C-b s :: display-bookmark
- C-b d :: delete-gemini-bookmark
2020-05-08 15:45:43 +02:00
* BUGS
2021-11-16 16:26:28 +01:00
There are many, totally unknown, hiding in the code; this is scary!
😱 Please help the programmer to nail them using the
2023-06-20 19:57:30 +02:00
[[https://codeberg.org/cage/tinmop/issues/][issue tracker]].
2020-05-08 15:45:43 +02:00
* Contributing
There is always need for help, you can join the developer, sending
patches or translating the UI to your favourite language.
Just point your browser to the
2023-06-20 19:57:30 +02:00
[[https://codeberg.org/cage/tinmop/][code repository]].
2020-05-08 15:45:43 +02:00
See also the file CONTRIBUTE.org
** Debug mode
If you uncomment the line:
#+BEGIN_SRC lisp
;;(push :debug-mode *features*)
#+END_SRC
The program will be compiled in ~debug-mode~ this means that a lot
of diagnostic output will be appended to a file named ~tinmop.log~
in the directory ~$HOME/.local/share/tinmop/~.
* Files
- ~$HOME/.local/share/tinmop/db.sqlite3~: the program database
- ~$HOME/.local/share/tinmop/client~: the program credentials to connect with the instance *keep private!*
- ~$HOME/.local/share/tinmop/tinmop.log~: this file is created only for debugging and should not be enabled in binary package distribution (see [[Contributing]]).
- ~/etc/tinmop/default-theme.conf~: default visual style
- ~/etc/tinmop/shared.conf~: some default configuration not related to themes
- ~/etc/tinmop/init.lisp~: system wide configuration
- ~$HOME/.config/tinmop/init.lisp~: user configuration
- ~$HOME/.config/tinmop/main.conf~: user configuration (simple format)
2020-05-08 15:45:43 +02:00
* Privacy
2021-11-16 16:26:28 +01:00
The author of this software collects no user data information with
this software.
But this software is a client to connect and interact to one or more
2021-11-16 16:26:28 +01:00
remote computer. So potentially it could share a lot of information
with other actors but just after the user allowed it to do so.
It is the user responsibility to checks the privacy conditions of the
instance this software connect to.
By default, pressing "!" will contact the remote service located at:
"gemini://houston.coder.town/search".
2021-11-16 16:26:28 +01:00
Moreover launching ~quick_quicklisp.sh~ will contact
[[https://www.quicklisp.org/]], check the
[[https://beta.quicklisp.org/quicklisp.lisp][quicklisp sources]] for
details.
2020-05-08 15:45:43 +02:00
* Acknowledgment
My deep thanks to the folks that provided us with wonderful SBCL and
Common lisp libraries.
In particular i want to thanks the authors of the libraries Croatoan and Tooter
for their help when I started to develop this program.
There are more people i borrowed code and data from, they are mentioned
in the file LINCENSES.org
This program was born also with the help of CCCP: "Collettivo
Computer Club Palermo".
2020-05-16 14:57:48 +02:00
Also thanks to "barbar" for testing of the installation scripts.