A program to build, display and manipulate the structures used by the CRYSTAL quantum-chemistry code, to animate the vibrational modes computed from them, and to plot the properties a calculation returns.
CRYSTALLine is in beta. Errors are to be expected, and bug reports, suggestions, comments and requests for new features are all welcome.
Installation
Python 3.11 or newer, in an environment of its own:
conda create --name crystal python=3.12 && conda activate crystal
pip install CRYSTALLine
crystalline
If it does not start, crystalline --check reports what is missing. See the
installation page.
What it does
- Displays crystals, slabs, polymers and molecules in an interactive 3D view, with their crystallography beside them — space group or layer group, lattice parameters, density — recomputed as the structure is edited.
- Reads the vibrational modes from a CRYSTAL output and animates them, at Γ and at the q points of a dispersion calculation, with export to GIF, MP4 and more.
- Edits structures: atoms, elements, cells, supercells, and the symmetry itself.
- Writes CRYSTAL (
.d12) and properties (.d3) input decks from the structure on screen, with the band path chosen on the Brillouin zone. - Plots what comes back: electronic bands and densities of states, IR and Raman spectra, elastic properties, equations of state, phonon bands, XRD.
The documentation describes each of these in turn.
License
GNU General Public License v3.0 or later.
Acknowledgements
Built on the CRYSTALClear I/O and plotting framework for the CRYSTAL code, and following in the tradition of MOLDRAW, written by Prof. Piero Ugliengo.
Developed with the assistance of Claude (Anthropic), using Claude Code.
Contact
- Website: https://www.crystal.unito.it
- Email: crystalunito@gmail.com
- Instagram: @crystaldevs
1 maintainer
Metadata
1 maintainer
Release files for CRYSTALLine 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| crystalline-0.3.1.tar.gz | 1.2 MB | With provenance | Details for crystalline-0.3.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| crystalline-0.3.1-py3-none-any.whl | Python 3 | none | any | Details for crystalline-0.3.1-py3-none-any.whl |
Total release size: 2.1 MB
Release files / crystalline-0.3.1.tar.gz
| Download URL | crystalline-0.3.1.tar.gz |
|---|---|
| Size | 1.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a97fe7bfce2286e4d19956285dcfb29cff25322518eec64e31190d3962eba2f7
|
|
BLAKE2b-256 checksum How to use checksums |
a1c35629daa2bcf7ae9ddc27762b822a398677eac23f7329e04a217ad444a3ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logRelease files / crystalline-0.3.1-py3-none-any.whl
| Download URL | crystalline-0.3.1-py3-none-any.whl |
|---|---|
| Size | 916.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6cd169f6c2e03a6a87bcfeffe35fb96ddfa6bb7b8d10637eca23352f4794ddb6
|
|
BLAKE2b-256 checksum How to use checksums |
3e979ec65cc4b631d38ee72dc062bee52eac14fd1055dfd5f7097a50d5e7b5c4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logSecurity for CRYSTALLine 0.3.1
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for crystalline-0.3.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logA 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.
