~~NOTOC~~
{{ :xfce:xfce.mousepad.png?no link|}}
====== Mousepad ======

Mousepad is a simple text editor for Xfce

  * **[[#Introduction|Introduction]]**
  * **[[#Screenshots|Screenshots]]**
  * **[[#Settings|Settings]]**
  * **[[#Keybindings|Keybindings]]**
  * **[[#Required Packages|Required Packages]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Introduction =====

**Mousepad** aims to be an easy-to-use and fast editor. Our target is an
editor for quickly editing text files, not a development environment or an
editor with a huge bunch of plugins. On the other hand we try to use the latest
GTK features available, which means that if GTK adds something new in a major
release that is useful for the editor, we will likely bump the GTK dependency
and integrate this new feature in **Mousepad**.

----

===== Screenshots =====
<figure "Main window">
{{::apps:mousepad:4.16:mousepad_window.png|:apps:mousepad:mousepad_window.png}}
</figure>

<figure "View Preferences">
{{:apps:mousepad:4.16:mousepad_view_preferences.png|:apps:mousepad:mousepad_window.png}}
</figure>

<figure "Editor Preferences">
{{:apps:mousepad:4.16:mousepad_editor_preferences.png|:apps:mousepad:mousepad_editor_preferences.png}}
</figure>

<figure "Window Preferences">
{{:apps:mousepad:4.16:mousepad_window_preferences.png|:apps:mousepad:mousepad_window_preferences.png}}
</figure>


[[|Back To Top]]
----

===== Settings =====

The preferences dialog shown above is the easiest way to set Mousepad settings. Some of them are also accessible via the menubar, e.g. "Word Wrap" and "Auto Indent" in the "Document" menu.

All these settings, plus some "hidden" ones, are also accessible using GSettings command line tool. You can get a list of everything about Mousepad in GSettings with this command:

   gsettings list-recursively org.xfce.mousepad

Then, to enable e.g. automatic indentation, just do

   gsettings set org.xfce.mousepad.preferences.view auto-indent true

See ''man gsettings'' and ''gsettings help'' for more details.

A graphical alternative to ''gsettings'' is Dconf Editor, normally available from your distribution repositories: see https://wiki.gnome.org/Apps/DconfEditor.

==== Printing ====

The settings for printing are treated separately, in the file ''~/.config/Mousepad/mousepadrc''. Create this file if it does not exist, then carry out a printing operation to the end (you can print in a file), and Mousepad will fill in the configuration file with the values set in the print dialog. Be sure to leave the value of ''PageSetupSaved'' at ''true'' so that all settings are reloaded the next time you print.

[[|Back to Top]]
----

===== Keybindings =====

After its first use, Mousepad will generate the file ''~/.config/Mousepad/accels.scm'', containing the list of configurable keybindings. To customize a keybinding, uncomment the corresponding line by removing the semicolon at the beginning, then change the shortcut at the end of the line, without touching the rest.

[[|Back to Top]]
----

===== Required packages =====

Mousepad depends on the following packages:

  * [[https://www.gtk.org|GTK]] >=3.22.0
  * [[https://wiki.gnome.org/Projects/GLib|GLib]] >=2.52.0
  * [[https://gitlab.xfce.org/xfce/xfconf|xfconf]] >=4.12.0
  * [[https://wiki.gnome.org/Projects/GtkSourceView|GtkSourceView]] >=3.24.0

[[|Back to Top]]
----

===== Latest Release =====
{{rss>https://archive.xfce.org/feeds/project/mousepad 1 date description 2h}}

  * **[[https://archive.xfce.org/src/apps/mousepad/|Previous Releases]]**

[[|Back to Top]]

----
===== Source code repository =====
[[https://gitlab.xfce.org/apps/mousepad]]


[[|Back To Top]]
----
===== Reporting Bugs =====
  * **[[:apps:mousepad:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs


[[|Back To Top]]
----
[[:start|Back to main Xfce documentation page]]