I tried looking for the .emacs file for my Windows installation for Emacs, but I could not find it. Does it have the same filename under Windows as in Unix?
Do I have to create it myself? If so, under what specific directory does it go?
Copy and pasted from the Emacs FAQ, http://www.gnu.org/software/emacs/windows/:
On Windows, the .emacs
file may be called _emacs
for backward compatibility with DOS and FAT filesystems where filenames could not start with a dot. Some users prefer to continue using such a name, because Windows Explorer cannot create a file with a name starting with a dot, even though the filesystem and most other programs can handle it. In Emacs 22 and later, the init file may also be called .emacs.d/init.el
. Many of the other files that are created by Lisp packages are now stored in the .emacs.d
directory too, so this keeps all your Emacs related files in one place.
All the files mentioned above should go in your HOME directory. The HOME directory is determined by following the steps below:
C:\.emacs
exists, then use C:/
. This is for backward compatibility, as previous versions defaulted to C:/
if HOME was not set.Within Emacs, ~
at the beginning of a file name is expanded to your HOME directory, so you can always find your .emacs file with C-x C-f ~/.emacs
.
There's further information at HOME and Startup Directories on MS-Windows.
It should be stored in the variable user-init-file. Use C-H v user-init-file RET
to check. You can also open it directly by using M-x eval-expression RET (find-file user-init-file) RET
trailing garbage following expression
?
Commented
Nov 7, 2016 at 12:27
On my Vista box it's in C:\Users\<USER>\AppData\Roaming\
Note that it may NOT be enough to just type Ctrl-x Ctrl-f ~/.emacs
and create the file.
It may be that your Emacs application uses a different place to store your init file, and if so, then creating the file ~/.emacs simply creates a useless file which your Emacs application ignores.
Also, you may want to do more than just access the .emacs init file, but you may want to know where it is, i.e., its pathname.
To get at this there are two methods:
Easy way: type Ctrl + H V user-init-file Return
Slightly trickier way: You can find out where your system is storing its own .emacs file by:
c:/Users/user1/AppData/Roaming/.emacs.el
. This site emacswiki.org/emacs/DotEmacsDotD helped me realize I needed to name the file ~/.emacs.d/init.el
which meant the file in the file system was at c:\Users\user1\AppData\Roaming\.emacs.d\init.el
(not at all what I expected). I prefer setting the HOME environment variable and place the file in my %USERPROFILE%
directory which is the logical HOME directory on windows (at least as far as I'm concerned).
In Windows 7 put your init.el
file in C:\Users\user-name\AppData\Roaming\.emacs.d\
, where user-name is your user/login folder.
Take care so your init.el
file won't be named init.el.txt
. This is something Windows does if you create your file with some editor like Notepad.
On versions of Emacs on Windows above 22, it seems to have moved to
~/.emacs.d/init.el
, ~
being the value of your environment variable HOME (see Control Panel → System → Advanced → Environment variables).
The file itself might not exist. In that case just create it.
You must create an emacs initialization file. One is not automatically created. I had a similar issue and this answer tracks down what I did.
My issue was my ~/.emacs.el
file was not loading. Strange because this has always worked for me.
This question/answer helped me but I had to put my init file in the %USERPROFILE%\AppData\Roaming\.emacs.d\init.el
because this is apparently the default behavior on Windows.
To troubleshoot this, I ran the following in the emacs *scratch* buffer.
user-emacs-directory
"~/.emacs.d/"
When I saw user-emacs-directory
was ~/.emacs.d
, I simply moved my .emacs.el file to %USERPROFILE%\.emacs.d\init.el
. But this still didn't work.
I continued with expand-file-name
as shown below:
(expand-file-name user-emacs-directory)
"c:/Users/pats/AppData/Roaming/.emacs.d/"
Got to love how Windows works. (not) So I moved my emacs.el
file to the %USERPROFILE%\AppData\Roaming\.emacs.d\init.el
and this worked. The file was now being read. But I got other errors because my initialization file loaded other (personal emacs) files (in ~/myenv/emacs/*.el
.
Warning (initialization): An error occurred while loading ‘c:/Users/pats/AppData/Roaming/.emacs.d/init.el’:
Hum... Seems like all my files ~/myenv/emacs/*.el
would need to be moved in order for this to work but I didn't want to do that. Then I realized that because the HOME environment variable was not set, emacs was performing its default behavior.
SOLUTION
Once I set my windows HOME
environment variable to %USERPROFILE%
everything began to work like it has for the past 25 years. :-)
To set the HOME environment variable, I typed WindowsKey+"edit environment variables for your account" to open the Environment Variables dialog box, and entered HOME=%USERPROFILE%
.
Now my emacs initialization file .emacs.el is is back to its rightful place $HOME/.emacs.el
and not in %USERPROFILE%\AppData\Roaming\.emacs.d\init.el
To be fair, if Windows had just one place to put files for user installed packages the solution of making HOME=%USERPROFILE\AppData\Roaming
might be acceptable, but because some applications use %USERPROFILE%
, some use %USERPROFILE\AppData\Roaming
and others use %USERPROFILE\AppData\Local
it just makes it difficult to know where to find your configuration files.
I prefer having everything in my %USERPROFILE% or $HOME directory.
Another similar question was here:
After Emacs 27.1, emacs has started respecting the $XDG_CONFIG_HOME
. The init file or the init directory can now be found in $XDG_CONFIG_HOME/emacs/init.el
.
In Windows $XDG_CONFIG_HOME
could translate to %LOCALAPPDATA%
.
In any case you can use the following emacs variables to find out the location of the your initialization file by M-x eval-expression
user-init-file
or the emacs configuration directory
user-emacs-directory
As kanja answered, the path to this file is stored in the user-init-file
variable (or if no init file exists, the variable contains the default value for where to create it).
So regardless of which of the possible init file names you are using, and which directory it is in, you should be able to visit your init file with:
M-: (find-file user-init-file)
RET
Or display its full path in the echo area with:
M-: (expand-file-name user-init-file)
RET
On Emacs 23 and Windows 7 it only works if you set:
HKCU\SOFTWARE\GNU\Emacs\HOME
I've found that Emacs 22 will occasionally open either "C:\Documents and Settings\username\Application Data\.emacs", or just "C:\Documents and Settings\username\.emacs" on my XP machine. I haven't found an explanation for why it occasionally changes it's mind.
~ will always point to whatever the current instance of emacs thinks is HOME, but kanja's tip (C-h v user-init-file) will always tell you what ~/.emacs actually maps to.
HOME
environment variable differently, depending on how I start runemacs.exe
. If I start it from within the Explorer, HOME
is set to C:\Documents and Settings\username
, but if I start it from the Start Menu, HOME
is C:\Documents and Settings\username\Application Data
. Strange.
Commented
Dec 7, 2010 at 21:37
On Windows 8.1, if Emacs is started from Windows Explorer, a shortcut or from cmd console it uses C:\Users\<USER>\AppData\Roaming.emacs init file. When I start Emacs from PowerShell, Emacs looks for its init file in C:\Users\<USER> folder. The fix to this issue was to set the HOME user environment variable (Control Panel\System and Security\System->Advanced system settings->Advanced->Environment variables) to C:\Users\<USER>. After this change, no matter how I start Emacs, it uses the same init file (see the accepted answer of this question)
There is a list of directories based on your Windows version and extra information: http://www.gnu.org/software/emacs/manual/html_node/emacs/Windows-HOME.html
For WIndows7& Emacs26.3:
if HOME
environment is set, then the .emacs
file should be in that folder.
otherwise, it should be in c:\
.
In both cases, if .emacs
is not there, _emacs
should be used.
This is because we cannot create .emacs
file according to the windows file naming rules.(but we can download or copy it from somewhere else).