yafp/ttth

ttth (talk to the hand) is an electron based desktop app for online services like WhatsApp, Threema, Telegram, Twitter, Google and several others.

ttth

available for:

about

ttth (talk to the hand) is an electron based desktop app for online services like WhatsApp, Threema, Telegram, Google and several others.

It is:

• available for freebsd, linux, macOS and windows.
• inspired by apps like Franz and Rambox. Need to feature Hamsket here as good looking Rambox fork and Ferdi as Franz fork.
• free and open source

getting-started

download

Download the latest release from here.

install

Please see the installation instructions for more details.

services

While ttth supports a growing list of pre-configured services, you can as well add custom urls yourself (using the CUSTOM URL type). Please see the supported services for more details.

ui

ttth comes with several themes. This readme is only featuring the default theme.

Default theme

Please see the themes list for more details.

changelog

Please see the changlog for more details.

keyboard-shortcuts

Function	Linux	macOS	Windows
Homepage	F1	F1	F1
Report issue	F2	F2	F2
Changelog	F3	F3	F3
FAQ	F4	F4	F4
Releases	F5	F5	F5
Search updates	F9	F9	F9
Open developer console for current service	F10	F10	F10
Toggle Fullscreen mode	F11	F11	F11
Toggle developer console	F12	F12	F12
Show Settings	CTRL + ,	CMD + ,	CTRL + ,
Jump to next service	CTRL + 🡆	CMD + 🡆	CTRL + 🡆
Jump to previous service	CTRL + 🡄	CMD + 🡄	CTRL + 🡄
Jump to service tab 1	CTRL + 1	CMD + 1	CTRL + 1
Jump to service tab 2	CTRL + 2	CMD + 2	CTRL + 2
Jump to service tab 3	CTRL + 3	CMD + 3	CTRL + 3
Jump to service tab ...	CTRL + ...	CMD + ...	CTRL + ...
Jump to service tab 9	CTRL + 9	CMD + 9	CTRL + 9
Reload current service	CTRL + S	CMD + S	CTRL + S
Quit/exit the application	CTRL + Q	CMD + Q	CTRL + Q
Reload the application	CTRL + R	CMD + R	CTRL + R
Minimize window	CTRL + M	CMD + M	CTRL + M
Maximize window	CTRL + K	CMD + K	CTRL + K
Hide window	CTRL + H	CMD + H	CTRL + H

privacy

• ttth is using sentry to collect error reports. This helps heavily finding bugs which might occur only in some specific use-cases. Please see the sentry privacy policy for more details.
• ttth is not tracking it's users (i.e. using Google Analytics or similar)
• All data is stored locally only.
• Sessions will persist using the partition:persist attribute for electrons webview.

You are always welcome to check and even improve the code.

faq

Please see the FAQ for more details.

known-issues

Please see the known issues for more details.

discussion

• Github: click here to create an issue

license

Please see the LICENSE for more details.

disclosure

ttth is not affiliated with any of the supported apps/services.

support / fund

If you want to support the development of ttth you can fund me on:

• github
• patreon

---

developers

• Please see the contributing informations for more details.
• A list of all contributors can be found here.

ttth's Issues

add new service - xing

add xing as new service

Horizontal scrollable tabs

service-tabs should be horizontal scroll-able to handle the situation where the window-width is not big enough to show all tab-names at once.

maybe like that:

https://codepen.io/srees/pen/pgVLbm

reloading kills the title

current window title on load is

ttth 1.3.0

after reloading the app with CTRL + R the title fallsback to

ttth

add close-button to update information

user should be able to hide the information regarding available software updates.

Service - Mattermost - Cancel enable process

when enabling mattermost or slack, and the electron-prompt got cancelled

the following is missing:

• the button represeting the service status should be re-set to red. Right now it stays green, even if the service-activation itself was cancelled.

change app icon

use a new app icon

slack session doesn't survive application reload

restarting or reloading the app drops me out of my slack "workplace" and brings me back to the Wellcome to slack stuff

but it does NOT forget who am I just need to reenter my "workspace"

Add option to reload frontmost service

Users should be able to just reload the current / frontmost service

Service: WhatsApp - Unread count method broken

seems like the inject code to detect unread message count doesnt work anymore.

see rambox issue: #2289

electron-prompt - use placeholders

should use placeholders in the electron-prompt dialogs in

• mattermost
• slack

See p-sam/electron-prompt#39

Add help menu entry: clear local storage

Add help menu entry: clear local storage

Add help menu entry: clear cache

Add help menu entry: clear cache

Use F10 to toggle menubar instead of F3

Use F10 to toggle menubar instead of F3

Update to electron 5.x

Consider updating electron from 4.x to 5.x

See: https://github.com/electron/electron/blob/master/docs/api/breaking-changes.md

F3 does not work on MAC

hiding the menu with f3 doesn't work, nothing happens pressing f3

copy & paste short cuts not working (MAC)

cmd+c / +p do not copy stuff.

maybe related to #21 or #11

transparency - remove os specific window transparency / opacity

currently - on windows and osx:

• app in focus: 1.0
• app blur : 0.9

removing this os-specific behaviour would make more sense.

mainWindow.setOpacity(0.9);

...as in: window has always 1.0 - let the os handle such things.

UI: Settings tab - remove tab text - show icon only

to reduce the width we could

• remove the Settings text fro mthe settings tab
• just show the settings icon

Settings - show 2 services per line to reduce height

should show 2 services per line in the settings view to reduce the height.

mac - autostart via LaunchAgent

Autostart on macos should be realized via LaunchAgend - not via auto-launch's default (appleScript)

Dock icon is gray - should be green

Expected Behavior

Dock icon should be green

Actual Behavior

Dock icon is gray

Steps to Reproduce the Problem

Specifications

• Version: 1.0.0
• Platform: linux / AppImage
• Subsystem: UI

Mac shortcuts

Expected Behavior

cmd+, => preferences
cmd+h => hide window
...

Actual Behavior

nothing happens :)

electron prompt - icon usage is broken

the electron-prompts are currently not showing the proper app icon.

Setting: hide menubar on startup

add setting to hide menubar on startup

settings: add support for color styles

• user should be able to select a predefined css style in settings

redesign service-definitions and user-service-configurations

Should do a redesign cause the current way is ugly & unflexible

Windows is not longer experimental

Should remove the experimental footer text for windows

menu - add entry to open console

users should be able to open DevTool Console from menu

electron-prompt usage - hide menubar

see:
p-sam/electron-prompt#37

promptWindow.setMenu(null);
promptWindow.setMenuBarVisibility(opts.menuBarVisible);

should hide the menubar in the slack & mattermost dialogs - after the function got added to electron-prompt package.

Settings - Default view is not working

Expected Behavior

configured default view should be loaded on appstart

Actual Behavior

• App loads settings on default
• Localstorage has SettingDefaultView = Twitter
• Dropbox shows "Please choose"

Steps to Reproduce the Problem

Specifications

• Version: 1.0.0
• Platform: linux / AppImage
• Subsystem: Settings / DefaultView

F12 should toggle console - not just open it

currently F12 opens the dev console

should switch from 'open' to a 'toggle' mode.

Add unread message function for google messages service

Add unread message function for google messages service

Service Twitter - Add unread count for DMs

Twitter should have a badge count for unread DMs

right click is not working

The webviews of the services don't support context-menus so far

Right click results in no action at all

Search update function - should always show result when manually triggered

Expected Behavior

Manually searching for updates should always show the result of this search

Actual Behavior

Manually searching for updates (via menu) shows only a feedback when a new version is available

Steps to Reproduce the Problem

1. Menu -> Help -> Search updates

Specifications

• Version: 1.2.0
• Platform: linux

Services - Add new service Google Drive

Should add google Drive as well as service

Settings tab - optimize space

could try to optimize space usage here

• button-size
• font size (h3)
• remove description(info text for Service section & startup section.

UI - add splash screen

add a simple first version of a pseudo-splash screen

just featuring the app logo

CSS / UI: Shrink tab size

tabs should be shrinked to save space

Reduce opacity of window if it looses focus

If the app loses focus it should reduce the opacity from 1.0 to 0.9
If it gets focus again the value should be changed back to 1.0

Limitations: Windows & Mac only.

Services - Open urls in external browser

Expected Behavior

Click on a link in random service should open the link in external browser

Actual Behavior

click results in no action at all

Steps to Reproduce the Problem

1. Click a link

Specifications

• Version: 1.0.0
• Platform: linux
• Subsystem: Service Whatsapp, Mattermost .... most likely valid for all chat-style services

improve css - reduce white border on left/right/bottom

should reduce the borders on left/right/bottom

window title - show active service name in addition to current information

Right now the window title is kinda static:

ttth 1.3.0

Assuming a user is currently in the Settings Tab - it should be:

ttth 1.3.0 - Settings

If he then jumps to moattermost the title should be:

ttth 1.3.0 - Mattermost

formatting thing in notification

:)

Add pacman build

https://www.electron.build/multi-platform-build

To build pacman: sudo apt-get install --no-install-recommends -y bsdtar.

Service Mattermost - fix setting webview src while enabling the service

While enabling mattermost, the user-defined url was not instantly set to the webview.
This resulted on issues on first using the service after having it configured.

Service - Slack: After enabling slack - ttth shows only empty page

seems like enabling slack in ttth itself works - the service shows the correct url afterwards while hovering it.

BUT - and thats the big but ...it loads the wrong url

shortcut for services

that would be nice ...

cmd+1 => first service
cmd+2 => second service ...

(cmd aka super)

mac - tray issues

Expected Behavior

should show a proper tray icon

Actual Behavior

• tray icon is displayed full size, but gets cropped by the size of the menubar
• next to the tray icon the app name is displayed (ttth)

Steps to Reproduce the Problem

1. Run current code on osx

Specifications

• Version: 1.0.0
• Platform: mac / darwin

window title should show app version

currently the window only shows the appname

should customize it to show title and version.