CDisplayEx
Mobile
Desktop
Discord Twitter Facebook Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Settings

Locations

Learn more about locations

To add a new location, use the large + button at the top right. A menu appears and offers you to select the type of location.

All locations types have 3 settings in common:

Description
Customize location description, if left blank then an auto generated description will be used.
Display on Home Page
Pin the location to the home page.
Add to Library
Add the location to the library.
You can reorder the locations on the homepage by going to settings and long pressing on a location.

Download Folder

The Downloads folder is a special location that you cannot delete. When you download a file from a remote location it is stored here. By default it is located in a private application folder. Use the yellow folder button to select a different location.

Device Storage

This type of location allows you to select internal storage as well as an SD card and a USB key.

Use the folder icon to select a path. If the application has full access to the files you will see this internal dialog box to the application allowing you to select a folder, use the icons at the top to select an SD card or a USB key.

If the application does not have full access to the files, you will see a system screen allowing you to select and grant rights to a folder.

Shared Drive (Samba)

Samba is a protocol used for file sharing and is available on many devices. Windows, MacOS, Linux, NAS, Router. It allows you to read Comics in streaming without having to download them first. Streaming is only available in the premium version.

Host name
The ip address or computer name. Preferably use an ip address if the device enters hibernation (NAS).
Username & password
The username and password to access the Samba server.
Path
If the server is accessible and the authentication is valid, you can select a remote path by pressing the folder icon.
When streaming, preferably use a 5G wifi network to reduce latency.
If you enable anonymous mode on Windows, you will still need to specify a username and password in the application. The username must not exist in Windows and must not be “ANONYMOUS”. The password must not be empty, put anything.
This protocol is made to be used in local area network (LAN). If you want to use it on a remote network, I advise you to disable streaming and thumbnails to avoid latency.

See also: General Samba settings

FTP

Use this protocol to access a remote server, if the server is on a local network, use Samba instead.

Host name
Host name or IP Adress
Username & password
The username and password to access the FTP server.
Port
Optional, the default port is 90 or 990 if you enable SSL.
SSL
FTP over SSL
Path
If the server is accessible and the authentication is valid, you can select a remote path by pressing the folder icon.
  • FTP over SSH is not supported.
  • On Linux I recommend you to use Pure-FTPd
  • If you use VsFTPd with SSL, this parameter is necessary in the configuration: “require_ssl_reuse=NO”

Google Drive

Google Drive is only available in the premium version. Shared folders and Google Workspace are supported. This cloud service does not support archive streaming.

Sign in with Google
This button opens your default browser to an authentication page.
Path
If the authentication is valid, you can select a remote path by pressing the folder icon.

You can enable reading status synchronization for files stored in this cloud service.

If a folder on your Drive is inaccessible, such as a synced backup, create a shortcut.

Dropbox

Dropbox is only available in the premium version. This cloud service does not support archive streaming.

Sign in
This button opens your default browser to an authentication page.
Path
If the authentication is valid, you can select a remote path by pressing the folder icon.

One Drive

Microsoft One Drive is only available in the premium version. This cloud service does not support archive streaming.

Sign in
This button opens your default browser to an authentication page.
Path
If the authentication is valid, you can select a remote path by pressing the folder icon.
If you installed Microsoft Edge as your default web browser, authentication may not work. Change the default browser temporarily to authenticate.

Mega

Mega.nz is only available in the premium version. Two-factor Authentication (2FA) is supported. This cloud service does not support archive streaming.

Sign in
This button opens a login screen.
Path
If the authentication is valid, you can select a remote path by pressing the folder icon.

Komga

Komga is only available in the premium version. It is a comic/manga media server. It is possible to install it on the local network or a dedicated server on the Internet. Streaming and syncing of reading status works with this service.

Host name
Host name or IP Adress. Ex:
192.168.1.12
computer.local
demo.komga.org
user.host.net/komga
Username & password
The username and password to access the Komga server.
Port
Optional, the default port is 80 or 443 if you enable SSL.
SSL
Use SSL.
Path
If the server is accessible and the authentication is valid, you can select a remote path by pressing the folder icon.
If you have disabled the page dimensions analysis option, re-enable it, it is absolutely necessary to open books.

By default the reading status is synchronized.

Also read the Komga documentation on how to read with CDisplayEx.

General

General

Allow management of all files

For versions of Android 11 and above, this option allows you to give full access to the device’s storage. See also Security

Open archives

Commonly used file extensions for Comics are cbr,cbz,cb7,cbt and correspond respectively to WinRar, WinZip, Seven Zip and Tar formats. Enable this option to also open files with the extension rar, zip, 7z and tar.

Open folders of images

Allows folders containing images to be opened as if they were books. The folder must contain at least two valid images, it must not contain subfolders or archives. This only works with device storage and the Samba protocol.

Open PDFs

Allows the app to open Adobe PDFs files.

Enable suggestions

Displays in the “Reading” section the next book to read in a series when you have finished reading an issue. The next book to read also depends on this option: Open Next Book

Cumulative folder statistics

View cumulative statistics for nested folders. On large libraries this option can slow down the display of browse screens and the home page when the thumbnail option on folders is enabled.

Night mode

Night mode is available in the premium version, it has 3 states:

  • Yes: always active.
  • No: never active.
  • Automatic: follows the system settings.

User interface language

In the premium version you can to change the language of the application independently of regional settings.

Thumbnail Options

Show a thumbnail on folders

Displays thumbnail and statistical information on nested folders.

Allow grid view of folders

Allows nested folders to be displayed as a grid.

Series and Folders

Customize thumbnail dimensions for nested folders and series.

The automatic setting will select the closest size to the image from the other available sizes. If you are viewing covers of very different sizes, then the thumbnails will not be aligned.

Books

Customize thumbnail dimensions for books.

The automatic setting will select the closest size to the image from the other available sizes. If you are viewing covers of very different sizes, then the thumbnails will not be aligned.

Portrait columns

When the display is in grid mode, this parameter allows you to choose the number of columns in portrait mode.

The automatic parameter calculates the number of columns so that the thumbnails are about 1 inch wide.

Landscape columns

When the display is in grid mode, this parameter allows you to choose the number of columns in landscape mode.

The automatic parameter calculates the number of columns so that the thumbnails are about 1 inch wide.

Synchronise read status

Enables synchronization of the read status and read progress of files stored on the following services. This is useful if you use multiple devices or need to reinstall the app.

Reading status and read progress are synced at different times when you use the app.

  • When you sync location manually. (Make a long press on the location and start the synchronization)
  • When you browse or refresh a series folder from a location.
  • When you open and close a book.
  • When the app goes into the background while a book is open.

Komga

This function is natively supported by Komga, the reading status is specific to each user.

Google Drive

Read status is attached to each file in application-specific metadata. When the same file is shared between several people, each user can synchronize his own reading status but within the limit of 30 people.

Samba

Samba protocol version

Selects the Samba protocol version. The default version is SMB2. It is not recommended to use the SMB1 protocol, it is not secure, use it only if you have no choice (old router). SMB3 is not yet available.

Extract thumbnails

Allows the extraction of thumbnails on the Samba protocol.

Allow streaming

Allow streaming of archives over the Samba protocol.

Use original file name

If your library does not follow naming conventions, these options allow you to use the original filename and not a normalized version.

Dislay

Displays the original filename rather than the normalized version.

Search using the original filename rather than information extracted from the filename.

The bottom navigation bar is customizable, you can decide to display certain actions permanently or make them accessible from a menu.

Reader

Cache size (Megapixel)

The cache size is a very important parameter for devices with little memory and a low resolution screen. To help you choose the right value, here’s how the app uses cache:

In single page mode, the application will cache 4 images, in double page mode it will be 6, the images will be resized to fit in the cache. In continuous reading mode it will be 3 screens and the images will be resized according to the zoom and screen resolution. If you enable 32 bits color, then each pixel will use 4 bytes instead of 2.

ex: 24 MP, 16 bits color mode, Single page mode.
24 MP x 2 Bytes ≈ 48 MB
24 MP = 4 pages x (3029 x 1980)

True color (32 bits)

By default, images are converted to 16-bit color (RGB565), which has the advantage of dividing memory consumption by 2 with imperceptible visual degradation in most cases. You will see a difference in the gradients, if you have a recent device with enough memory, do not hesitate to activate 32-bit true colors.

Resume reading

When the application closes while reading, because it has been in the background for too long or because you have deliberately closed it, then it can be annoying to have to reopen the book you were reading. Activate this option to reopen the book being read when the application is launched.

Open comic at last page

When the book is opened, the application selects the last page being read.

Keep screen on

Prevents the screen from going to sleep while you read.

Immersive Reader

The app is pre-configured for immersive reading without visual distraction, which is why the notification bar and virtual navigation buttons are hidden by default. Disable this option for a non-immersive mode.

Show the notch area

If you have a front-facing camera built into your screen, then part of your screen is unavailable during reading. By activating this option the application will reuse this wasted space.

Automatic background color

Some areas where no page is displayed are black. Enable this option to color these spaces using the most common page border color.

Page Border

A thin dark border is drawn between pages in double-page spread and continuous reading mode. Especially useful for manga.

Crop Border

Attempts to remove empty borders to save space. The proportions of the image are preserved in order not to disturb the fluidity of the display and the transitions.

This setting will be used as the default for all books. You can then define a specific parameter for each book in the reading interface.

Color corrections

Enables automatic color correction.

This setting will be used as the default for all books. You can then define a specific parameter for each book in the reading interface.

Right to left reading order

If you only read right-to-left manga, enable this option.

This setting will be used as the default for all books. You can then define a specific parameter for each book in the reading interface.

Vertical reading direction

If you only read magazines that are read top to bottom, enable this option.

This setting will be used as the default for all books. You can then define a specific parameter for each book in the reading interface.

Double tap to scroll

This finger gesture allows to simulate a horizontal and vertical scroll bar. To use it, double tap the screen and hold your finger on the screen on the second tap. Then move your finger as if moving a scroll bar. This is useful in continuous reading mode or to have a magnifying effect. If you tend to trigger this gesture by mistake, you can simply turn it off.

Open next book

These options allow you to determine how the app finds the next book to read. These settings affect suggestions and the next book feature in the reader interface.

Use original file name

By default the application uses the series name and the issue number extracted from the filename to find the next book, but sometimes when the naming conventions are not always respected it does not always work. By activating this option the sort is performed on the filename to find the next book.

Search Current Folder

By default the application searches for the next book in all library folders. This can be a problem when there is another series in your library with the same name but from a different year. By activating this option only the book of the same folder will be selected.

Page transitions

These options have been designed specifically for eReader devices. They are useful for disabling page-turning transitions.

Slide gesture

Allow page change by dragging the current page.

Tap gesture

Allows page change by touching the screen with a single tap.

After disabling this setting, assign next and previous page actions to the volume buttons.

Animations

Scroll distance

When the app automatically scrolls to follow the reading flow, the view is moved a distance equal to 100% of the width or height of your screen. Depending on the zoom level, this value is reduced to equalize the distance between scrolls needed to reach the edge of the page. You can reduce this value to avoid too abrupt cuts in the content.

Scroll duration

Scroll and page change animations have a duration of 500ms by default. Do not hesitate to adjust this value to have better reading comfort on your device.

Zoom duration

Zoom animations have a duration of 500ms by default. Do not hesitate to adjust this value to have better reading comfort on your device.

Controls

Reverse controls in Right-To-Left mode

When reading from right to left, this option reverses the controls you have assigned to areas of the screen.

On screen control

The screen is divided into nine areas to which you can assign different actions on a single press and a long press.

Volume control

To avoid touching the screen you can assign controls to volume buttons.

Four additional actions can be assigned on the bar located at the bottom right of the reader.