Skip to content

Commit 33e2368

Browse files
authored
Merge pull request #5 from lstein/release/name-change
rename PhotoMap->PhotoMapAI
2 parents 4cbc75d + 577fe98 commit 33e2368

11 files changed

Lines changed: 83 additions & 83 deletions

File tree

docs/configuration.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
# Configuration
22

3-
PhotoMap is primarily configured through the web interface as described in [Basic Usage](user-guide/basic-usage.md#changing-settings) and [Albums](user-guide/albums.md). However, there are a number of runtime parameters that control how the web service behaves.
3+
PhotoMapAI is primarily configured through the web interface as described in [Basic Usage](user-guide/basic-usage.md#changing-settings) and [Albums](user-guide/albums.md). However, there are a number of runtime parameters that control how the web service behaves.
44

55
## Changing the Web Host and Port
66

7-
By default, PhotoMap runs its web service on port 8050 and only accepts connections on the local machine (`localhost`). These can be changed on the command line used to launch the application using the `--port` and `--host` options:
7+
By default, PhotoMapAI runs its web service on port 8050 and only accepts connections on the local machine (`localhost`). These can be changed on the command line used to launch the application using the `--port` and `--host` options:
88

99
start_photomap --port 8000 --host 0.0.0.0
1010

11-
This command changes the port to port 8000, and allows PhotoMap to listen for connections on the wildcard IP address `0.0.0.0`, meaning that it will accept connections for any network-accessible location.
11+
This command changes the port to port 8000, and allows PhotoMapAI to listen for connections on the wildcard IP address `0.0.0.0`, meaning that it will accept connections for any network-accessible location.
1212

13-
If you are using a launcher script to start PhotoMap (e.g. `start_photomap.bat`) you can change these values by opening the script in a text editor (`Notepad` on Windows), finding the line containing `start_photomap`, and adding the options as shown above.
13+
If you are using a launcher script to start PhotoMapAI (e.g. `start_photomap.bat`) you can change these values by opening the script in a text editor (`Notepad` on Windows), finding the line containing `start_photomap`, and adding the options as shown above.
1414

15-
Alternatively, you can change the port and host interface by setting two environment variables prior to launching PhotoMap. These are:
15+
Alternatively, you can change the port and host interface by setting two environment variables prior to launching PhotoMapAI. These are:
1616

1717
* `PHOTOMAP_HOST` - the host interface to accept connections from
1818
* `PHOTOMAP_PORT` - the listen port
@@ -27,16 +27,16 @@ Or you can permanently fix these environment variables by setting them in your s
2727

2828
On Windows systems, setting environment variables can be done through the GUI as well as on the command line. See [How to Set Environment Variables in Windows](https://phoenixnap.com/kb/windows-set-environment-variable) for a good walkthrough.
2929

30-
## Running PhotoMap Under HTTPS
30+
## Running PhotoMapAI Under HTTPS
3131

32-
By default, PhotoMap runs as a non-secure `HTTP` service. This generates a warning icon in some browsers, but more seriously prevents cut and paste between the PhotoMap tab and browser tabs and desktop applications.
32+
By default, PhotoMapAI runs as a non-secure `HTTP` service. This generates a warning icon in some browsers, but more seriously prevents cut and paste between the PhotoMapAI tab and browser tabs and desktop applications.
3333

34-
There are several ways to enable HTTP for PhotoMap:
34+
There are several ways to enable HTTP for PhotoMapAI:
3535

3636
### Install a Self-Signed SSL Certificate
3737

3838
In this method, you generate self-signed encryption certificate and
39-
private key files and point PhotoMap to them using its `--cert` and
39+
private key files and point PhotoMapAI to them using its `--cert` and
4040
`--key` command-line options.
4141

4242
Guides to generating and installing self-signed certificates:
@@ -46,14 +46,14 @@ Guides to generating and installing self-signed certificates:
4646
- [Creating Self-Signed Certificates with OpenSSL (Mac/Linux)](https://gist.github.com/elklein96/a15090f35a41e16bdc8574a7fb81e119)
4747

4848
These methods will leave you with two files, a .crt certificate file,
49-
and a .pem key file. Relaunch the PhotoMap server using `--cert
49+
and a .pem key file. Relaunch the PhotoMapAI server using `--cert
5050
/path/to/.crt file` and `--key /path/to/.pem file`. If you are using
5151
the desktop launcher to start the server, simply open the launcher
5252
file with a text editor, and add the `--cert` and `--key` options to
5353
the end of the line that ends with `start_photomap`.
5454

5555
After installing the certificate/key pair and relaunching the server,
56-
you will be able to access the PhotoMap server using the https://
56+
you will be able to access the PhotoMapAI server using the https://
5757
URL. Your browser will complain about an unknown certificate authority
5858
when you first load the URL and ask you to confirm that you trust the site.
5959

@@ -64,14 +64,14 @@ browsers automatically trust. It is very easy to use, but it requires that you
6464
have a web running on port 80 that accepts incoming HTTP connections.
6565

6666
Once the Certbot certificate and keyfile are generated, follow the
67-
directions in the previous section to configure PhotoMap to use them.
67+
directions in the previous section to configure PhotoMapAI to use them.
6868

6969

7070
### Use a Reverse Proxy
7171

72-
A final option is to keep PhotoMap running on HTTP, but use a reverse
72+
A final option is to keep PhotoMapAI running on HTTP, but use a reverse
7373
proxy from a running web server to translate HTTPS requests on the
74-
reverse proxy into HTTP requests to PhotoMap. The main advantage of this
74+
reverse proxy into HTTP requests to PhotoMapAI. The main advantage of this
7575
is that you get the additional benefit of all the web server's configuration
7676
controls, such as the ability to add password protection.
7777

@@ -89,12 +89,12 @@ You will need to install encryption certificates for the Nginx server using [Cer
8989

9090
This is saying that when a request comes in for
9191
`https://your.host/photomap/` it will be translated into a request to
92-
`http://localhost:8050/` where PhotoMap is running. It is possible to
93-
run the proxy server and the PhotoMap server on separate machines as well.
92+
`http://localhost:8050/` where PhotoMapAI is running. It is possible to
93+
run the proxy server and the PhotoMapAI server on separate machines as well.
9494

9595
## Pointing to an Alternative Configuration File
9696

97-
PhotoMap stores its album definitions and other configuration information in a configuration file. It is not usually necessary to manipulate it directly, but if you wish you can point to an alternative config file in order to have multiple PhotoMap servers each hosting separate album collections.
97+
PhotoMapAI stores its album definitions and other configuration information in a configuration file. It is not usually necessary to manipulate it directly, but if you wish you can point to an alternative config file in order to have multiple PhotoMapAI servers each hosting separate album collections.
9898

9999
The config file is stored in different places depending on the platform:
100100

@@ -104,11 +104,11 @@ The config file is stored in different places depending on the platform:
104104
| MacOS | ~/Library/Application Support/photomap/config.yaml |
105105
| Windows | C:\Users\<user>\AppData\Roaming\photomap\config.yaml|
106106

107-
To run PhotoMap off a different config file, you may launch it with the `--config` option on the command line, similar to setting the port and host. In the below example we specify an alternative config file named `photomap_2.yaml`
107+
To run PhotoMapAI off a different config file, you may launch it with the `--config` option on the command line, similar to setting the port and host. In the below example we specify an alternative config file named `photomap_2.yaml`
108108

109109
start_photomap --config ~/photomap_2.yaml
110110

111-
If the indicated config file doesn't exist when you launch PhotoMap, it will be created automatically.
111+
If the indicated config file doesn't exist when you launch PhotoMapAI, it will be created automatically.
112112

113113
You may also point to an alternative configuration file by setting the environment variable `PHOTOMAP_CONFIG`, as described in the previous section:
114114

docs/developer/api.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# PhotoMap API Reference
1+
# PhotoMapAI API Reference
22

3-
PhotoMap is driven by a Pydantic data model and a series of FastAPI endpoints. You may access and test these endpoints using [http://localhost:8050/docs](http://localhost:8050/docs)
3+
PhotoMapAI is driven by a Pydantic data model and a series of FastAPI endpoints. You may access and test these endpoints using [http://localhost:8050/docs](http://localhost:8050/docs)
44

55
## Album Management Endpoints
66

docs/developer/architecture.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
# PhotoMap Architecture
1+
# PhotoMapAI Architecture
22

3-
PhotoMap is a modular web application designed for efficient photo management, AI-powered search, and interactive visualization. Its architecture is organized into distinct layers and components to ensure scalability, maintainability, and ease of development.
3+
PhotoMapAI is a modular web application designed for efficient photo management, AI-powered search, and interactive visualization. Its architecture is organized into distinct layers and components to ensure scalability, maintainability, and ease of development.
44

55
---
66

77
## Overview
88

9-
PhotoMap consists of three main layers:
9+
PhotoMapAI consists of three main layers:
1010

1111
1. **Frontend**
1212
- Built with HTML, CSS, and JavaScript (ES6 modules).

docs/developer/frontend.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Frontend Architecture
22

3-
The PhotoMap frontend is a modular, responsive web application built with HTML, CSS, and JavaScript (ES6 modules). It provides an interactive user interface for browsing, searching, and visualizing photo collections.
3+
The PhotoMapAI frontend is a modular, responsive web application built with HTML, CSS, and JavaScript (ES6 modules). It provides an interactive user interface for browsing, searching, and visualizing photo collections.
44

55
---
66

docs/index.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
# PhotoMap
1+
# PhotoMapAI
22

33
Rediscover your photo collection!
44

5-
PhotoMap is a fast, modern image browser and search tool for large photo collections. It supports text and image-based search, semantic clustering, and interactive slideshows with a responsive web interface. Its unique feature is a "semantic map" that clusters and visualizes your images by their content. Browse the semantic map to find and explore thematically-related groups of photos, or use text and/or image similarity search to find specific people, places, events, styles and themes.
5+
PhotoMapAI is a fast, modern image browser and search tool for large photo collections. It supports text and image-based search, semantic clustering, and interactive slideshows with a responsive web interface. Its unique feature is a "semantic map" that clusters and visualizes your images by their content. Browse the semantic map to find and explore thematically-related groups of photos, or use text and/or image similarity search to find specific people, places, events, styles and themes.
66

77
<div class="photomap-overlay-container">
88
<img src="img/photomap_slide_with_semantic_map_base.png" width="480" class="photomap-base" alt="Base image">
@@ -21,7 +21,7 @@ PhotoMap is a fast, modern image browser and search tool for large photo collect
2121

2222
## The Semantic Map
2323

24-
PhotoMap's unique feature is its ability to identify thematically similar images and automatically cluster them, creating a "semantic map":
24+
PhotoMapAI's unique feature is its ability to identify thematically similar images and automatically cluster them, creating a "semantic map":
2525

2626
<img src="img/photomap_big_semantic_map.png" alt="Big Semantic Map" class="img-hover-zoom">
2727

@@ -31,7 +31,7 @@ You can move the semantic map around, shrink it down in size, or hide it altoget
3131

3232
## Text and Image Similarity Search
3333

34-
PhotoMap lets you search your collection by similarity to another image, by text, or by a combination of image and text as shown below:
34+
PhotoMapAI lets you search your collection by similarity to another image, by text, or by a combination of image and text as shown below:
3535

3636
<img src="img/photomap_search_interface.png" alt="Big Semantic Map" class="img-hover-zoom">
3737

@@ -49,7 +49,7 @@ If you are a user of the [InvokeAI](https://github.com/invoke-ai/InvokeAI) text-
4949

5050
## Other Features
5151

52-
PhotoMap supports most of the other features you would expect, including support for multiple separate photo albums, the ability to browse photos chronologically, an uncluttered fullscreen mode, and of course a configurable slideshow mode that can show images sequentially or shuffled.
52+
PhotoMapAI supports most of the other features you would expect, including support for multiple separate photo albums, the ability to browse photos chronologically, an uncluttered fullscreen mode, and of course a configurable slideshow mode that can show images sequentially or shuffled.
5353

5454
---
5555

@@ -60,13 +60,13 @@ PhotoMap supports most of the other features you would expect, including support
6060

6161
#### 1. Download and unpack the source code
6262

63-
Download the PhotoMap source code as a .zip file from the latest stable Releases page. For development versions, use the "Download ZIP" link in the green "Code" button near the top of the GitHub PhotoMap home page.
63+
Download the PhotoMapAI source code as a .zip file from the latest stable Releases page. For development versions, use the "Download ZIP" link in the green "Code" button near the top of the GitHub PhotoMapAI home page.
6464

65-
Choose a convenient location in your home folder and unzip the file to create a new folder named `PhotoMap`.
65+
Choose a convenient location in your home folder and unzip the file to create a new folder named `PhotoMapAI`.
6666

6767
#### 2. Run the installer script
6868

69-
Navigate to the unpacked `PhotoMap` folder, find the `INSTALL` folder, and double-click the `install_windows` script file. The system will check that Python and other requirements are installed, download the necessary library files, and create a .bat script named `start_photomap`.
69+
Navigate to the unpacked `PhotoMapAI` folder, find the `INSTALL` folder, and double-click the `install_windows` script file. The system will check that Python and other requirements are installed, download the necessary library files, and create a .bat script named `start_photomap`.
7070

7171
#### 3. Start the server
7272

@@ -82,13 +82,13 @@ Double-click `start_photomap.bat` to launch the server. You should see a few sta
8282

8383
#### 1. Download and unpack the source code
8484

85-
Download the PhotoMap source code as a .zip file from the latest stable Releases page. For development versions, use the "Download ZIP" link in the green "Code" button near the top of the GitHub PhotoMap home page.
85+
Download the PhotoMapAI source code as a .zip file from the latest stable Releases page. For development versions, use the "Download ZIP" link in the green "Code" button near the top of the GitHub PhotoMapAI home page.
8686

87-
Choose a convenient location in your home directory and unzip the file to create a new folder named `PhotoMap`.
87+
Choose a convenient location in your home directory and unzip the file to create a new folder named `PhotoMapAI`.
8888

8989
#### 2. Run the installer script
9090

91-
Navigate to the `PhotoMap` folder and launch the `install_linux_mac` shell script file. The script will check that Python and other requirements are installed, download the necessary library files, and create a launcher script named `start_photomap` on your desktop.
91+
Navigate to the `PhotoMapAI` folder and launch the `install_linux_mac` shell script file. The script will check that Python and other requirements are installed, download the necessary library files, and create a launcher script named `start_photomap` on your desktop.
9292

9393
#### 3. Start the server
9494

0 commit comments

Comments
 (0)