Skip to content

Latest commit

 

History

History
133 lines (88 loc) · 6.79 KB

README.md

File metadata and controls

133 lines (88 loc) · 6.79 KB

Sailcord

Previously SailDiscord

An unofficial SailfishOS Discord client

Basic functionality is already there. More features are coming through updates

By using this, you are breaking Discord Terms of Services! This app might even get you banned! It stores your token in plain text and it is really easy to hack you with it!

Join the Telegram channel for Sailcord development logs and releases.

Join SailfishOS Fan Club Discord server! Besides general SailfishOS discussion, it also has several Sailcord-related channels including info, discussion and major announcements like releases.

TODO

  • Login
  • Servers
  • Text channels
    • Text
    • Attachments
      • Full support for downloading and sharing
      • Photos and GIFs (non-embedded)
      • Unknown files
      • Preview for other types (videos, etc.)
    • Embeds
      • GIFs from Giphy, Tensor, etc.
      • General embeds/EmbedProxy support
  • DMs
  • Caching
    • Avatars
  • References (forwarded, replies)
  • Markdown and emojis
  • Automate translating with weblate or anything similar

Known issues

  • App lags in a text channel sometimes. Very similar to the issue below except this one lags besides being slow
  • App is very slow at loading almost everything. This is not fully fixable because app uses Python as the backend, which is slow
  • Friend requests might fail because of captcha. If other things fail because of it for you please report it

Troubleshooting

Login page isn't loading!

Check if you are able to open https://discord.com/login in the native browser. If you can't, here are the possible workarounds:

  • Update to ESR91 beta
  • Login using token (see below)

Logging in via token

See discord.py-self docs page for up to date information. In short, you should:

  • Login into discord with a desktop web browser
  • Open developer tools (ctrl+shift+i on most browsers) and click on Console
  • Type this code and press enter: (webpackChunkdiscord_app.push([[''],{},e=>{m=[];for(let c in e.c)m.push(e.c[c])}]),m).find(m => m?.exports?.default?.getToken).exports.default.getToken()
  • Copy the token it will show you without the quotes (")

After obtaining you token, in Sailcord top menu, when logging in, choose Login with token. Then paste your token and click Accept.

Screenshots

Server list (classic) Modern overview A channel Me (modern)

Screenshots are for version 0.8.0

Translating

Read instructions here. Make sure not to skip them even if you know how to translate other apps, because there are some pitfalls. When reading instruction, replace appname with saildiscord, and when opening translations folder open SailDiscord -> translations folder. translate as usual or read that guide ignoring opal stuff

Build

Removing the debug flag (disabling faster build)

Get Sailfish IDE, open the project, open Other Files -> rpm -> SailDiscord.spec, then replace no in the first line with yes if you want to make a production package. Now just run or build.

Faster build (disable library packaging, NOT RECOMMENDED IN PRODUCTION)

If you didn't replace, you'll get faster build but aditional steps needed for phone. This is only required once. Once the installation is completed, open Terminal from the developer options on your phone and type this command:

python3 -m pip install --user --upgrade "discord.py-self>=2.0" "requests" "Pillow"

Then open the app. If you ever want to switch back to the production version, type this command to undo:

python3 -m pip uninstall discord.py-self

SailJail will NOT work in this case

Some general build issues

  • You might need to remove the build_folder/deps/google/_upb folder Should not be needed now.
  • There's an issue that the BuildRequires: python3-pip; line in the spec file throws an error. A workaround for now is to build these two awesome projects for the same target as for this project - harbour-moremahjong and sailfish-rpn-calculator.
    • A fix could be to use python3 -m ensurepip --default-pip instead of BuildRequires: python3-pip; in the spec, but it might break the build vm/container so I am not recommending it. You can still do so by uncommenting a line in the spec file.
    • The fix has been found, and it turns out very simple. Open the project in Sailfish IDE, right click on it in the file structure and click Run QMake.
  • You might need to cd into the build folder, run sfdk config target=<a target> and then sfdk build-shell --maintain, finally inside that shell run python3 -m pip install --upgrade pip.

Code Design

  • When sharing discord snowflake IDs between Python and QML, they should be converted to strings. QML can mess up with large integers so strings are used. IDs are never really operated in QML except for sending them back to Python in exchange for other data.

Credits

The code is based on:

Core functionality:

Developers:

Contributors (translations):