Skip to main content

CalCleaner

Github Discord Github Actions Black License

A simple graphical tool to purge old events from CalDAV calendars

Screenshot of Calcleaner

Requirements

Python:

Install

Flatpak (Linux)

A Flatpak package is available on Flathub. This is currently the simplest way to install CalCleaner on all major Linux distributions:

Linux (source)

First, you will need to install some dependencies on your system. On Debian and Ubuntu this can be achieved with the following command:

sudo apt install git build-essential python3 python3-dev python3-pip libgirepository-2.0-dev pkg-config gir1.2-gtk-3.0

Then clone this repository and navigate to it:

git clone https://github.com/flozz/calcleaner.git
cd calcleaner

Then install CalCleaner using pip:

sudo pip3 install .

Finally, you can install desktop file, icons and manual using the following command:

sudo ./linuxpkg/copy-data.sh /usr

Linux (PyPI)

First, you will need to install some dependencies on your system. On Debian and Ubuntu this can be achieved with the following command:

sudo apt install git build-essential python3 python3-dev python3-pip libgirepository1.0-dev pkg-config gir1.2-gtk-3.0

Then install CalCleaner using pip:

sudo pip3 install calcleaner

NOTE: Installing from PyPI will not install .desktop file and man page. You will not be able to run the software from your graphical app menu (GNOME Shell,…).

Contributing / Hacking

Questions

If you have any question, you can:

Bugs

If you found a bug, please open an issue on Github with as much information as possible:

  • What is your operating system / Linux distribution (and its version),

  • How you installed the software,

  • All the logs and message outputted by the software,

  • …

Pull Requests

Please consider filing a bug before starting to work on a new feature. This will allow us to discuss the best way to do it. This is of course not necessary if you just want to fix some typo or small errors in the code.

Please note that your code must pass tests and follow the coding style defined by the pep8. Flake8 and Black are used on this project to enforce coding style.

Translating Calcleaner

If the software is not available in your language, you can help translate it.

To translate Calcleaner, you can submit your translations using a Pull Request on Github,

Do not forget to add your name as the translation of the translator-credits key (one name per line, e-mail is optional):

msgid "translator-credits"
msgstr ""
"John DOE\n"
"Other TRANSLATOR <foobar@example.org>\n"

Running the project

First, install dependencies (preferably in a virtualenv):

pip install -e ".[dev]"

Then run:

python -m calcleaner

Coding Style / Lint

This project follows Black’s coding style.

To check coding style, you will first have to install nox:

pip3 install nox

Then you can check for lint error (Flake8 and Black):

nox --session lint

You can fix automatically coding style with:

nox -s black_fix

Tests

Tu run tests, you will first have to install nox:

pip3 install nox

Then run the following command:

nox -s test

Extract, Update or Build Translations

You will first have to install nox:

pip3 install nox

To extract messages and update locales run:

nox --session locales_update

To compile locales, run:

nox --session locales_compile

NOTE: you will need to have xgettext, msgmerge and msgfmt executable installed on your system to run the above commands. On Debian / Ubuntu, they can be installed with the following command:

sudo apt install gettext

Regenerating Icons

To regenerate icons, Inkscape must be installed. On Debian and Ubuntu you can install it with the following command:

sudo apt install inkscape

You will also need nox to run the generation command:

pip3 install nox

Once everithing installed, you can regenerate icons with the following command:

nox -s gen_icons

Supporting this project

Wanna support this project?

Changelog

  • [NEXT] (changes on master but not released yet):

    • Nothing yet ;)

  • v1.1.4:

    • misc(deps): Fixed caldav dependency to <2.0.0 due to breaking changes (@flozz, #25)

    • docs: Updated dependencies install in doc (@moi90 #24)

    • misc: Added Python 3.12, 3.13, 3.14, 3.15 support (@flozz)

    • misc!: Removed Python 3.7, 3.8, 3.9, 3.10 support (@flozz)

  • v1.1.3:

    • Added Turkish translation (@sabriunal, #8)

  • v1.1.2:

    • Added Croatian translation (@milotype, #7)

    • Added Python 3.11 support

  • v1.1.1:

    • Added German translation (Jürgen Benvenuti)

  • v1.1.0:

    • UI improvements:

      • Double border removed in calendar view

      • Accessibility improved by changing the widgets used to build the “pages” of the main window

    • Translations:

      • Dutch (#5, @Vistaus)

      • Brazilian Portuguese (incomplete)

  • v1.0.0:

    • Allow to disable SSL certificate validation (self-signed certificate, etc.)

    • Improve error message on SSL errors

    • Set the user agent string to “CalCleaner/<VERSION>”

    • Fix calendar of removed account still displayed after closing account management dialog

    • Fix a crash when cleaning an empty (malformed) event

    • Italian translation (#1, @albanobattistella)

  • v0.9.1 (beta):

    • Fix data not included in packages

  • v0.9.0 (beta):

    • Initial release

    • French translation

Metadata

Release files for calcleaner 1.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for calcleaner 1.1.4
File Size Uploaded Provenance Actions
calcleaner-1.1.4.tar.gz 56.1 kB Without provenance Details for calcleaner-1.1.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for calcleaner 1.1.4
File Interpreter ABI Platform Actions
calcleaner-1.1.4-py3-none-any.whl Python 3 none any Details for calcleaner-1.1.4-py3-none-any.whl

Total release size: 119.1 kB

Release files / calcleaner-1.1.4.tar.gz

Download URL calcleaner-1.1.4.tar.gz
Size 56.1 kB
Tags Source
SHA-256 checksum
How to use checksums
41b5dffabc1a64aaaac86d0123ef02caf1c30abf7143238cb3bbe9f53dcc739e
BLAKE2b-256 checksum
How to use checksums
b763acda9a32601d86de4fdfd70f3cb1cd1e50fa81fe3273e01b378c0b29fe2c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / calcleaner-1.1.4-py3-none-any.whl

Download URL calcleaner-1.1.4-py3-none-any.whl
Size 62.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8516ea922a6a11e6f60b1969447ef3cb15d5be1a7eb6fea6c5f67904689fe21d
BLAKE2b-256 checksum
How to use checksums
3a27d9b73b448f7958d75e5f579fdd12d0cb58cda22dd3b99d5ca414a07ec101
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for calcleaner 1.1.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page