Cutlery/calibre
1
0
Fork 0
mirror of https://github.com/kovidgoyal/calibre.git synced 2025-07-09 03:04:10 -04:00
Code Issues Packages Projects Releases Wiki Activity

Add a FAQ entry about black screen in viewer

Browse Source
This commit is contained in:
Kovid Goyal 2022-07-19 09:49:44 +05:30
parent 07f8817974
commit b959c961e0
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C
2 changed files with 16 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
manual/customize.rst
View File

@ -29,6 +29,9 @@ calibre has a highly modular design. Various parts of it can be customized. Her
plugins
.. _customize_env_vars:
Environment variables
-----------------------

14
manual/faq.rst
View File

@ -928,6 +928,16 @@ solve it, look for a corrupted font file on your system, in ~/Library/Fonts or t
check for corrupted fonts in macOS is to start the "Font Book" application, select all fonts and then in the File
menu, choose "Validate fonts".
I get only a black or white screen when running the calibre E-book viewer?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This will be because of an incompatibility between Qt WebEngine, which the
viewer uses to render and the GPU drivers on your system. First try
upgrading the GPU drivers. If that does not help, you can try turning off
hardware acceleration in Qt WebEngine by setting the environment variable
``QTWEBENGINE_CHROMIUM_FLAGS`` to the value ``--disable-gpu``.
See :ref:`customize_env_vars` for how to change environment variables.
I downloaded the installer, but it is not working?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -1074,7 +1084,7 @@ a modern Linux distribution, you should have no problems installing calibre onto
do require the X server libraries to be installed on your system. This is
because of Qt, which is used for various image processing tasks, and links
against these libraries. If you get an ImportError about some Qt modules,
you are likely missing some X libraries. Typicall candidates are:
you are likely missing some X libraries. Typical candidates are:
``libxcb-xinerama0``, ``libegl1``, ``libopengl0``.
You can run the calibre server via the command::
@ -1085,7 +1095,7 @@ You can download news and convert it into an e-book with the command::
/opt/calibre/ebook-convert "Title of news source.recipe" outputfile.epub
If you want to generate MOBI, use outputfile.mobi instead and use ``--output-profile kindle``.
If you want to generate MOBI, use :file:`outputfile.mobi` instead and use ``--output-profile kindle``.
You can email downloaded news with the command::