Konversation/Konvi2x

From KDE UserBase Wiki
Revision as of 03:01, 21 September 2017 by Hein (talk | contribs)

Preface

This page aims to get you started with the WIP branch that will one day become Konversation 2.x.

Work log

Wondering what's new already? What follows is a (sporadically updated!) list of new features and abilities vs. the stable Konversation 1.7.x version:

Interface layout
* Responsive/collapsible two-column design enables useful small/mini window mode

Text view
* Hanging indent / all messages start at the same column
* Groups consecutive messages by the same author
* Does not repeat timestamp when unnecessary
* Can update colors dynamically for backlog


Tab completion
* Most-recently-active-nick-first now works in popup mode
* Popup mode has much better ergonomics than before
* Completion now ignores special characters in nicknames
* Basic command completion
* Completion now works in private conversations (all nicks on the server)


Input field
* You can now have a shared input field (with shared history) between all tabs
* History system now restores cursor position when arrow'ing back down to last 
  edited text


Under the hood
* Model/view architecture allows dynamic filtering of chat contents (i.e. 
  retroactive show/hide of joins and parts) or combined views
* Lower memory usage due to less redundant document data and not keeping 
  unnecessary text views around

Also check out this blog post for our goals!

Sources

Work is being carried out on the wip/qtquick branch of the konversation.git repository.

Check out the general build instructions first.

Build dependencies

The WIP branch has higher version demands for some dependencies as well as new dependencies. Specifically:

  • Qt 5.9.x
  • Master branch of KF5::Kirigami (kirigami.git)
  • Master branch of qqc2-desktop-style (qqc2-desktop-style.git)

Getting the branch

In contrast to the general build instructions, either clone this way:

git clone git://anongit.kde.org/konversation --branch wip/qtquick

... or run these commands in an existing git clone dir:

git fetch origin
git checkout wip/qtquick

Flatpak

NOTE: We're still working on tuning the Flatpak generation. If it's broken, try again the next day - sorry!

We also have a Flatpak nightly package.

Check out the KDE Flatpak HOWTO first.

To install, run:

flatpak remote-add kderuntime --from http://distribute.kde.org/kderuntime.flatpakrepo
flatpak remote-add kdeapps --from https://distribute.kde.org/kdeapps.flatpakrepo
flatpak install kdeapps org.kde.konversation-konvi2x

This will add a "(Nightly) (Konvi2x) Konversation" entry into your desktop menu.

Running the branch (imporant - read here!)

At any time, you can use the F10 key to switch between the old and new Konversation UIs.

The following command line examples expand on each other. To show the new Qt Quick-based UI immediately at start, run Konversation like this:

konversation --qtquick

Konversation is usually only allowed to run once. To bypass this restriction and run a second instance of Konversation, run Konversation like this:

konversation --qtquick --nui

To avoid auto-connecting to your networks with a test build, run Konversation like this:

konversation --qtquick --nui --noautoconnect

This last example is good set of arguments for hacking and testing. Additionally, you can override the UI package with --uipackage <package name>.

Update: The branch now installs a konvi2x executable that's equivalent to konversation --qtquick --nui.

Links