Metadata-Version: 2.4
Name: songpress
Version: 1.9.0rc4
Summary: Songpress is a free, easy to use song typeset program for Windows and Linux, that generates high-quality songbooks.
License: GNU GPL v2
Author: Luca Allulli
Author-email: luca@skeed.it
Requires-Python: >=3.9
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: pyshortcuts (>=1.9.5,<2.0.0)
Requires-Dist: python-pptx (>=1.0.2,<2.0.0)
Requires-Dist: requests (>=2.32.4,<3.0.0)
Requires-Dist: wxPython (>=4.2.4,<5.0.0)
Project-URL: Homepage, https://www.skeed.it/songpress
Project-URL: Issues, https://github.com/lallulli/songpress/issues
Project-URL: Source, https://github.com/lallulli/songpress
Description-Content-Type: text/markdown

Songpress is a free, easy to use song typeset program for Windows and Linux, that generates high-quality songbooks.

Songpress is focused on song formatting. Once your song is ready, you can copy-paste it into your favorite program, to give your songbook the look you like the most.

### Windows Installation

To install Songpress on Windows, we provide a [network installer](https://github.com/lallulli/songpress/releases/download/1.9.0rc1/songpress-net-setup.exe)
that downloads and installs the latest available version of Songpress.

Songpress is distributed through [PyPI](https://pypi.org/project/songpress/), the standard repository for Python packages. The network installer uses `uv` to:

1. Check whether a recent version of Python is already installed on your system. If not, the installer will download a local version of Python dedicated to Songpress.
2. Download and install Songpress along with all its dependencies (locally).

All installed files are contained in a single folder within your _Program Files_ directory, allowing Songpress to be cleanly uninstalled using its own uninstaller.

### Linux Installation

On Linux, you can install Songpress using `pipx`:

```bash
pipx install songpress
```

Alternatively, you can use `uv`:

```bash
uv tool install songpress
```

The installation process may take several minutes, as the installer needs to download and compile the wxPython and wxWidgets libraries. Once installed, you can run Songpress by typing:

```bash
songpress
```

You can create a start menu (application menu) shortcut by executing:

```bash
songpress --create-shortcuts
```

To upgrade Songpress on Linux, run:

```bash
pipx upgrade songpress
```

### Highlights

- Produce **high-quality guitar scores** (text and chords)
- **Easy** to learn, quick to use
- You can **paste formatted songs** into any Linux and Windows application, to layout your songbook with maximum flexibility (Affinity, Microsoft Word, LibreOffice, Microsoft Publisher, Inkscape etc.)
- **Export** formatted songs to PNG and HTML (web pages and snippets)
- **Chord transposition** with automatic key detection
- **Chord simplification** for beginner guitarists: determine the easiest key to play your song, and transpose it automatically
- Support several **chord notations**: American (C, D, E), Italian (Do, Re, Mi), French, German and Portuguese; notation conversion
- Support Chordpro and Tab (i.e. two-line) **chord formats**
- **Clean up** dirty songs with spurious blank lines (such as songs copied and pasted from web pages) and not homogeneous chord notations


Learn more at http://www.skeed.it/songpress
  
### Known Issues

__Linux: SVG export and display scaling__

When the system display scaling factor is not set to 1, the SVG output produced by Copy as Image may be incorrectly formatted. This is a known issue in the current wxPython release. The underlying problem [has already been fixed upstream in wxWidgets](https://github.com/wxWidgets/wxWidgets/issues/25707) and will be resolved automatically once the next version of wxPython becomes available.

