---
id: appdata
version: "2.2.1"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# appdata — Utils to manage application data folder.

License: permissive · Maintenance: dormant · Downloads: 346.6K/mo

## What it is and what it does

AppData is a lightweight utility for managing application data directories across Linux, macOS, and Windows. It abstracts away OS-specific conventions—such as ~/.myapp on Unix or %APPDATA% on Windows—into a single AppDataPaths class that you instantiate with your application name. Once set up, it provides ready-made paths for logs, configuration files, and the main app data folder, eliminating the need to hardcode platform-specific directory logic.

The package has no external runtime dependencies and installs as a pure Python wheel. It is marked Production/Stable and dormant since late 2023, making it a stable choice for applications that need predictable, OS-compliant data storage without ongoing churn. Use it when you want to avoid manual path construction and ensure your app respects platform conventions.

Use it for:

- Set up standard log and config directories for a CLI tool on first run across Windows, macOS, and Linux.
- Store user-specific application settings in the OS-standard location without platform-specific conditionals.
- Create a consistent folder structure for caching or temporary data that persists across application restarts.
- Simplify testing by providing a predictable, isolated app data path that can be mocked or redirected per test.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a cross-platform abstraction for managing application data directories, logs, and configuration files in standard OS-specific locations.

Yes. AppData solves a genuine cross-platform problem with zero dependencies, a permissive license, and stable code. Install it if your application needs to store data, logs, or config files and you want to respect OS conventions without writing platform detection logic yourself. The dormant status is not a concern for a utility this narrow in scope.

## Install

pip install appdata
uv add appdata
poetry add appdata

## Installing appdata

Before you install: Low friction to install; the package is dormant (last commit 2023-12-26, 962 days ago) but carries no runtime dependencies and is marked Production/Stable.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for most projects.

Quickstart:

pip install appdata

from appdata import AppDataPaths

app_paths = AppDataPaths('myapp')
app_paths.setup()
print(app_paths.app_data_path)
print(app_paths.logs_path)

Verify before relying:

- Whether the package supports Python versions beyond 3.8 (classifiers list 3.5–3.8 but requires_python is unspecified)
- Whether dormancy (last commit 962 days ago) affects compatibility with recent OS changes to app data directory standards

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 346.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

application data directory management, cross-platform app config paths, user data folder abstraction, application logs and config paths, os-specific data directory, app folder structure setup, cross-platform, filesystem-paths, app-configuration

[View on SkillFed](https://skillfed.io/packages/appdata) · [View on PyPI](https://pypi.org/project/appdata/)