---
name: "File::HomeDir::Darwin::Carbon"
section: "3pm"
platform: "linux"
package: "perl-file-homedir"
version: "1.006-8"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/File::HomeDir::Darwin::Carbon"
---

# File::HomeDir::Darwin::Carbon(3pm)

Find your home and other directories on Darwin (OS X)

## NAME

File::HomeDir::Darwin - Find your home and other directories on Darwin (OS X)

## DESCRIPTION

This module provides Darwin-specific implementations for determining common user directories.  In normal usage this module will always be used via File::HomeDir.

Note -- since this module requires Mac::Carbon and Mac::Carbon does not work with 64-bit perls, on such systems, File::HomeDir will try File::HomeDir::Darwin::Cocoa and then fall back to the (pure Perl) File::HomeDir::Darwin.

## SYNOPSIS

```
  use File::HomeDir;
  # Find directories for the current user
  $home    = File::HomeDir->my_home;      # /Users/mylogin
  $desktop = File::HomeDir->my_desktop;   # /Users/mylogin/Desktop
  $docs    = File::HomeDir->my_documents; # /Users/mylogin/Documents
  $music   = File::HomeDir->my_music;     # /Users/mylogin/Music
  $pics    = File::HomeDir->my_pictures;  # /Users/mylogin/Pictures
  $videos  = File::HomeDir->my_videos;    # /Users/mylogin/Movies
  $data    = File::HomeDir->my_data;      # /Users/mylogin/Library/Application Support
```

## TODO

- •

  Test with Mac OS (versions 7, 8, 9)

- •

  Some better way for users\_\* ?

## COPYRIGHT

Copyright 2009 - 2011 Adam Kennedy.

Copyright 2017 - 2020 Jens Rehsack