Go to file
miruka 8b37ca2524 Add a persistent zoom setting to settings.json
The zoom keybinds now modify this setting directly.
The `uiScale` property in themes now default to using this zoom setting,
since just removing it would need of annoying changes through theme
files and QML code, and is best left to until the future theming
overhaul update.
2020-09-01 14:19:40 -04:00
.github/ISSUE_TEMPLATE Improve issue templates 2020-06-27 16:55:54 -04:00
extra Default background: less blur, redone screenshots 2020-03-21 14:56:36 -04:00
packaging Update flatpak nio requirements 2020-08-28 10:45:37 -04:00
src Add a persistent zoom setting to settings.json 2020-09-01 14:19:40 -04:00
submodules Get SortProxyFilterModel stuff working? 2020-02-12 05:56:18 -04:00
.gitignore Adjust flatpak packaging script according to the feedback 2020-03-25 22:27:40 +02:00
.gitmodules Change name and bump version 2020-03-10 10:41:27 -04:00
CHANGELOG.md Fix v0.6.2 changelog typos 2020-08-28 11:25:49 -04:00
COPYING Initial commit 2019-03-21 23:28:14 -04:00
COPYING.LESSER Start rewriting backend with pyotherside+asyncio 2019-06-27 02:31:03 -04:00
INSTALL.md utils.h: check for Q_OS_LINUX, not _UNIX 2020-07-16 23:05:02 -04:00
live-reload.sh Better comment live-reload.sh 2020-06-05 11:07:10 -04:00
mirage.pro Make libX11 & libXScrnSaver optional on Linux 2020-07-16 19:09:09 -04:00
README.md Add new 0.6.1 features in the README 2020-08-23 09:16:27 -04:00
requirements-dev.txt Add dev requirements, switch main to upstream nio 2020-06-05 09:33:49 -04:00
requirements.txt Bump nio required version to v0.15.0 2020-08-21 12:10:22 -04:00
TODO.md Add a persistent zoom setting to settings.json 2020-09-01 14:19:40 -04:00

Mirage

Latest release
Built with matrix-nio
#mirage-client:matrix.org

Features
Installation
Configuration & Theming
Screenshots

A fancy, customizable, keyboard-operable Matrix chat
client for encrypted and decentralized communication.
Written in Qt/QML and Python, currently in alpha.

Chat screenshot

Currently Implemented Features

Interface

  • Fluid, responsive interface that adapts to any window size
  • Toggleable compact mode
  • Customizable keyboard shortcuts for everything, including
    switching rooms, navigating messages, sending/opening files...
  • Versatile theming system, properties can refer to each other and have
    any valid ECMAScript 7 expression as values
    • Comes by default with dark and transparent themes

Accounts

  • Multiple accounts in one client
  • Built-in public homeservers list
  • SSO and password authentication
  • Set your display name and profile picture
  • Import/export E2E key files
  • Inspect, rename, manually verify and sign out one or multiple sessions
  • Sessions for accounts within the same client automatically verify each others
  • Set your account's presence to online, unavailable, invisible or offline
  • Set custom status messages
  • Automatically set your status to unavailable after a period of inactivity

Rooms

  • Create, join, leave and forget rooms

  • Send, accept and refuse invites

  • Edit the room's name, topic, invite requirement, guest access and enable E2E

  • Kick, ban and set the power level of users

  • Unread message and highlight counters

  • Sending read receipts to mark rooms as read

  • Inspect and manually verify other users's E2E sessions

  • See other users's presence, status message and last seen time

  • Typing notifications

Messages

  • Send and receive E2E encrypted messages

  • Send and receive emote messages (e.g. /me reads attentively)

  • Receive notice (bot) messages

  • Send markdown formatted messages

    • Additional syntax for coloring text, e.g. <red>(Some text...) -
      SVG/CSS color names,
      and #hex codes can be used
  • Send and receive normal or E2E encrypted files

  • Client-side Matrix & HTTP URL image previews, including animated GIF

  • Upload images by pasting

  • Full-size image viewer

  • User ID, display names, room ID and room aliases mentions

  • Autocompletion for usernames and user ID

  • Individual and mass message removal

  • Sending rich replies

Installation

See INSTALL.md

Configuration & Theming

The config file can be found at $XDG_CONFIG_HOME/mirage/settings.json,
or ~/.config/mirage/settings.json.

For Flatpak users, this will be
~/.var/app/io.github.mirukana.mirage/config/mirage instead.

The config folder where accounts.json and settings.json is located can be
overriden by setting the MIRAGE_CONFIG_DIR environment variable.

The user data folder where themes, encryption data and interface states
are saved can be overriden with MIRAGE_DATA_DIR.

The cache folder where downloaded files and thumbnails are saved can be
overriden with MIRAGE_CACHE_DIR.

The theme setting can be:

  • The filename of a built-in theme (Midnight.qpl or Glass.qpl)
  • The filename of a custom theme at
    $XDG_DATA_HOME/mirage/themes, ~/.local/share/mirage/themes,
    or ~/.var/app/io.github.mirukana.mirage/data/mirage/themes (Flatpak)

A default theme from this repository can be copied to use as a base and edit,
for example:

    cp mirage/src/themes/Midnight.qpl \
       "${XDG_DATA_HOME:-$HOME/.local/share}/mirage/themes/MyTheme.qpl"

Or for Flatpak users:

    cp mirage/src/themes/Midnight.qpl \
       ~/.var/app/io.github.mirukana.mirage/data/mirage/themes/MyTheme.qpl

The config setting theme would need to be set to MyTheme.qpl in this case.

Theme files are nested-by-indentations sections of properties and values.
Properties are declared as <type> <name>: <value>.
Values can be any JavaScript (ECMAScript 7) expressions.

Most of the properties are of type color.
Their values, if not just refering to another property,
can be expressed with a:

  • SVG/CSS color name
    string, e.g. "blue"
  • Hexadecimal code string, e.g. "#fff" or "#cc0000"
  • RGBA value, using the Qt.rgba(0-1, 0-1, 0-1, 0-1) function
  • HSLA value, using the Qt.hsla(0-1, 0-1, 0-1, 0-1) function
  • HSVA value, using the Qt.hsva(0-1, 0-1, 0-1, 0-1) function
  • HSLUV value, using the
    hsluv(0-360, 0-100, 0-100, 0-1) function. This is the prefered method
    used throughout the default theme files
    (why? see this and
    that)

If you just want to change the background picture,
or use a gradient/simple color instead, search for the ui: section in your
text editor.

With Alt+Shift+R by default, the config and theme can be reloaded without
restarting the app.

Warnings:

  • API currently unstable: theme properties are often renamed, added or deleted.
  • The file format for both config and themes will soon change
  • The current file format forces all theme to have all properties
    defined, instead of being able to only specify the ones to override from the
    default theme.

GUI settings will also be implemented in the future.

Screenshots

Sign-in
Account settings
Room creation
Chat
Main pane in small window
Chat in small window
Room pane in small window