Skip to content

Latest commit

 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MatrixFS

Mount a Matrix account as a filesystem - folders as spaces and files as rooms.

Features

  • Send, receive, edit, delete messages
  • Support for encrypted rooms
  • Media upload/download
  • Integration with all text editors (just open the file!)

You wouldn't believe how much water I boiled for this.

Warning

Is this secure? Probably. Claude wrote the code - all I know is:

  • It used the Matrix Rust SDK, which is secure
  • Session ID is stored in keyring

How to use

  1. Install MatrixFS
    cargo install --git https://github.com/libreslop/matrixfs
  2. Create an empty file and mount MatrixFS, mounting can take a while as initial sync is slow.
    mkdir matrix && matrixfs ./matrix
  3. Open the directory to see the directory structure, it should be immediate obvious what each file do
    .
    |-- users
    |-- rooms/
    |   |-- room1/
    |   |   |-- users/
    |   |   |-- media/
    |   |   `-- chat.mx.md
    |   `-- room2
    `-- spaces/
        |-- subspace1
        `-- room2
    

To logout, simply unmount the filesystem.

Message operations

To chat, you edit the file and save it. Each save can only perform one operation (on one message).

Operation How do?
Send new message Write your message on a new line at the end of the file.
Edit a message Edit the content of the message in-line
Delete a message Remove the - at the start of the line and nothing else
Send a file Move the file into the media/ directory of the room

TODO

Well I'm not doing anything, Claude is.

  • Creating rooms/spaces/DMs by creating a file
  • Adding slash commands to rooms
  • File system based JSON API

About

Mount a Matrix account as a FUSE filesystem.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages